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PREFACE 


This  development  specification  covers  the  work  performed 
under  Air  Force  Contract  F33615-80-C-5155  C I CAM  Project  6201). 
This  contract  is  sponsored  by  the  Materials  Laboratory,  Air 
Foroe  Systems  Command,  Vright-Patterson  Air  Force  Base,  Ohio. 

It  was  administered  under  the  technical  direction  of  Mr.  Gerald 
C.  Shumaker,  I CAM  Program  Manager,  Manufacturing  Technology 
Division,  through  Project  Manager,  Mr.  David  Judson.  The  Prime 
Contractor  was  Production  Resources  Consulting  of  the  General 
Electric  Company,  Soheneotady,  Rev  Tork,  under  the  direction  of 
Mr.  Alan  Rubenstein.  The  General  Electric  Project  Manager  was 
Mr.  Myron  Hurlbut  of  Industrial  Automation  Systems  Department, 
Albany,  Rev  Tork. 

Certain  work  aimed  at  improving  Test  Bed  Technology  has 
been  performed  by  other  contracts  with  Project  6201  performing 
integrating  functions.  This  work  consisted  of  enhancements  to 
Test  Bed  software  and  establishment  and  operation  of  Test  Bed 
hardware  and  communications  for  developers  and  other  users. 
Documentation  relating  to  the  Test  Bed  from  all  of  these 
contractors  and  projects  have  been  integrated  under  Project  6201 
for  publication  and  treatment  as  an  Integrated  6et  of  documents. 
The  particular  contributors  to  each  document  are  noted  on  the 
Report  Documentation  Page  (DD1473).  A  listing  and  description 
of  the  entire  project  documentation  system  and  how  they  are 
related  is  contained  in  document  FTR620100001 ,  Project  Overview. 

The  subcontractors  and  their  contributing  activities  were 
as  follows: 


TASK  4.2 

Subcontractors 

Boeing  Military  Aircraft 
Company  (BMAC) 

D.  Appleton  Company 
(DACOM) 


General  Dynamics/ 
Ft.  Worth 


Role 

Reviewer 


Responsible  for  IDEF  support, 
state-of-the-art  literature 
search 

Responsible  for  factory  view 
function  and  information 
models 
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Role 


Subcontractors 

Illinois  Institute  of 
Technology 

north  American  Rockwell 
Northrop  Corporation 

Pritsker  and  Associates 
SofTech 

TASKS  4. S  -  4.9  (TEST  BED) 

Subcontractors 

Boeing  Military  Aircraft 
Company  (BMAC) 

Computer  Technology 
Associates  (CTA) 

Control  Data  Corporation 
(CDC) 


D.  Appleton  Company 
(DACOM) 


Responsible  for  factory  view 
funotion  researoh  (IITRI) 
and  information  models  of 
small  and  medium-sine  business 


Responsible  for  factory  view 
function  and  information 
models 

Responsible  for  IDEP2  support 
Responsible  for  IDEFO  support 


Assisted  in  the  areas  of 
communications  systems,  system 
design  and  integration 
methodology,  and  design  of  the 
Network  Transaction  Manager. 


Responsible  for  the  Common  Data 
Model  (CDM)  implementation  and 
part  of  the  CDM  design  (shared 
with  DACOM). 

Responsible  for  the  overall  CDM 
Subsystem  design  integration 
and  test  plan,  as  well  as  part 
of  the  design  of  the  CDM 
(shared  with  CDC).  DACOM  also 
developed  the  Integration 
Methodology  and  did  the  schema 
mappings  for  the  Application 
Subsystems . 


Reviewer 


Role 

Responsible  for  consultation  on 
applications  of  the  technology 
and  on  IBM  computer  technology. 
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Subcontractors 


Role 


Digital  Equi patent  Consulting  and  support  of  the 

Corporation  (DEC)  performance  testing  and  on  DEC 

software  and  computer  systems 
operation. 


McDonnell  Douglas 
Autonation  Company 
(McAuto) 


Responsible  for  the  support  and 
enhancements  to  the  network 
Transaction  Manager  Subsystem 
during  1984/1985  period. 


On-Line  Software 
International  (OSI) 


Responsible  for  programming  the 
Communications  Subsystem  on  the 
IBM  and  for  consulting  on  the 


IBM. 


Rath  and  Strong  Systems 
Products  ( RSSP )  (In  1985 
became  McCormack  9  Dodge) 


Responsible  for  assistance  in 
the  implementation  and  use  of 
the  MRP  II  package  (PIOS)  that 
they  supplied. 


SofTech,  Inc.  Responsible  for  the  design  and 

implementation  of  the  Network 
Transaction  Manager  (MTM)  in 
1981/1984  period. 


Software  Performance 
Engineering  (SPE) 


Responsible  for  directing  the 
work  on  performance  evaluation 
and  analysis. 


Structural  Dynamics 
Research  Corporation 
( SDRC ) 


Responsible  for  the  User 
Interface  and  Virtual  Terminal 
Interface  Subsystems. 


Subcontractors  and  other  prime  contractors  under  other 
projects  who  have  contributed  to  Test  Bed  Technology,  their 
contributing  activities  and  responsible  projects  are  as  follows: 

Contractors  ICAM  Project  Contributing  Activities 


Boeing  Military  1701, 
Aircraft  Company  2202 
(BMAC) 


2201 .  Enhancements  for  IBM 
node  use.  Technology 
Transfer  to  Integrated 
Sheet  Metal  Center 
( I SMC) 
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Contractors 

I CAM  Project 

Contributing  Activities 

Control  Data 
Corporation  (CDC) 

1508.  1701 

IXSS  enhancements  to 
Common  Data  Model 
Processor  CCDMP) 

D.  Appleton  Company 
(DACOM) 

1502 

IISS  enhancements  to 
Integration  Methodology 

General  Electric 

1502 

Operation  of  the  Test 
Bed  and  communications 
equipment . 

Hughes  Aircraft 

Conpany  (HAC) 

1701 

Test  Bed  enhancements 

Structural  Dynamics 
Research  Corporation 
(SDRC) 

1502.  1701. 
1703 

IISS  enhancements  to 
User  Interface/Virtual 
Terminal  Interface 
(UI/VTI) 

Systran 

1502 

Test  Bed  enhancements. 
Operation  of  Test  Bed. 
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SECTION  1 
INTRODUCTION 


This  Network  Transaction  Manager  (NTH)  Development 
Specification  (DS)  provides  the  design  of  the  functions  to  be 
implemented  by  the  NTH  in  the  Integrated  Information  Support 
System  (IISS)  test  bed.  This  specification  supersedes  in  part 
the  NTM  System  Design  Specification  and  the  KTM  Development 
Specification  for  MilestoneXA.  This  specification  views  the  NTM 
as  a  cohesive,  testable  (stand-alone)  system  with  well  defined 
external  interfaces  between  the  NTM  and  other  test  bed 
configuration  items.  This  document  further  defines  the  operating 
environment,  internal  interfaces,  and  the  database 
characteristics  for  the  NTM.  The  major  emphasis  is  the 
specification  of  the  processing  performed  by  the  NTM. 

The  format  and  content  of  this  specification  is  in 
conformance  with  the  ICAM  Documentation  Standard  (IDS 
1501 20000A )  for  a  Development  Specification. 

The  NTM  design  presented  in  this  document  was  derived  from: 
(1)  the  NTM  System  Specification,  System  Design  Specification, 
and  Development  Specification  for  Milestone  A;  (2)  technical 
review  meetings  with  General  Electric  and.  (3)  engineering 
judgement.  The  previous  NTM  Specifications  provided  detailed 
NTM  requirements.  Technical  review  meetings  with  GE  provided 
overall  IISS  system  requirements,  constraints,  and  functional 
interface  definitions.  Engineering  judgement  was  used  to  derive 
the  NTM  design  in  consideration  of  these  factors. 

The  NTM  external  and  internal  interfaces  have  been 
established  at  a  functional  level  in  Section  4.1.  Interfaces 
are  identified  between  NTM  and  the  Common  Data  Model  Request 
Processor,  the  User  Interface,  the  Communications  Handler, 
Integrated  and  Nonintegrated  Application  Processes,  and  Host 
Operating  Systems.  The  internal  interfaces  section  defines  the 
NTM  Message  Header  and  the  Monitor  AP  functionality. 

The  emphasis  of  this  document  is  found  in  Section  4.2  where 
the  NTM  functions  identified  in  the  IDEFXO  Model  (Appendix  B) 
are  described  as  to  their  inputs,  outputs,  and  processing 
requirements. 

The  NTM  data  characteristics  are  detailed  in  Section  4.5. 
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These  are  based  on  the  data  requirements  established  in  the 
earlier  NTH  Specifications.  The  efforts  in  this  area  have 
resulted  in  an  expanded  IDEFNl  data  model  (see  Appendix  C) . 

The  Appendix  to  this  document  provides,  in  addition  to  the 
IDEF  models,  the  data  dictionary  for  the  NTH  data  (Appendix  D) , 
the  definition  of  the  message  types  used  within  the  NTH 
(Appendix  E),  and  a  brief  explanation  of  error  message  handling 
within  the  NTM. 
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SECTION  2 
SCOPE 


2.1  Identification 

This  specification  establishes  the  performance, 
development,  test,  and  qualification  requirements  of  a  computer 
program  identified  as  the  Network  Transaction  Manager, 
hereinafter  referred  to  as  the  NTM.  The  NTM  is  one  configuration 
item  of  the  Integrated  Information  Support  System  (IISS). 

2.2  Functional  Summary 

The  NTM  Computer  Program  Configuration  Item  (CPCI)  provides 
control  and  support  services  to  application  processes  that  are 
grouped  together  logically  in  clusters  called  Application 
Process  Clusters  (APCs*).  The  sum  of  these  A PCs  is  the  IISS.  The 
IISS  is  a  system  that  incorporates  heterogeneous  host  machines 
into  a  network  to  provide  transaction  processing  services  within 
a  manufacturing  environment.  This  environment  is  discussed  in 
the  IDEFXO  mode!  (contained  in  Appendix  B  below). 

The  major  functions  of  the  NTM  are: 

a.  Manage  Message:  This  function  provides  for  the  receipt  and 
routing  of  messages  both  between  application  processes 
residing  on  a  cluster  and  between  clusters.  The  message 
manager  also  provides  authorization  checks,  message  and 
error  logging,  and  message  header  completion. 

b.  Manage  Process :  This  function  provides  direct  support  to 
the  application  processes  on  the  cluster  in  terms  of 
initiating  the  process,  communicating  with  the  process, 
enabling  abnormal  termination  or  shutdown,  and  monitoring 
the  process  status. 


•The  term  "Application  Process  Cluster"  (APC)  replaces  the  term 
"workstation"  as  used  in  all  previous  NTM  documentation.  In 
concept ,  the  two  terms  are  synonomous . 


DS  820142000 
1  Movenber  1085 


o.  Maintain  Qporabl 1 1 tv :  Thin  function  provides  the  overall 
o<mtrol  capabilities  of  IZSS  systen  startup  and  restart, 
recovery,  and  nonitoring.  This  funotion  also  oollects  and 
records  status  and  statistics.  This  is  a  systen-vide, 
host-wide  and  an  AFC  local  function. 
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SECTION  3 
DOCUMENTS 


3.1  Applicable  Documents 

The  following  documents  were  used  in  the  definition  of  the 
HTM  specification. 

3.1.1  Specifications 

[1]  Control  Data  Corporation  and  D.  Appleton  Co.  Inc.;  IISS 
Test  Bed  COM  Meeds  Analysis;  June  7,  1982;  IISS  Test 
Bed  CPU  State  of  the  Art;  June  7,  1982;  IISS  Test  Bed 
CDH  Environnent ;  June  7,  1982;  IISS  Test  Bed  CDM  Systen 
Requirements ;  June  7,  1982. 

[2]  General  Electric  Co.;  Test  Bed  Systen  Requirement 
Document  (Draft) ;  Revised  23  August  1982. 

[3]  ICAM  Computer-Based  Information  System  (CBIS)  System 
Requirements  Dooument  (Draft);  September  10,  1981;  Cl 
•SRD3 10 1400000 . 

|4)  SofTech,  Inc.;  IISS  Test  Bed:  Network  Transaction 
Manager  System  Specification;  May  1982. 

[5]  SofTech,  Inc.;  IISS  Test  Bed:  Network  Transaction 
Manager  System  Design  Specification;  July  1982. 

[6]  General  Electric  Co.;  Test  Bed  Systen  Specification 
(Draft);  23  August  1982. 

I 7 ]  SofTech,  Inc. ;  IISS  Test  Bed :  network  Transaction 
Manager  Development  Specification  (Mi lestone  A); 

October  1982 . 

[8]  SofTech,  Inc. ;  IISS  Test  Bed  Programmer ' s  Guide 
(Draft) ;  January  1983. 

[9]  General  Electric  Co.;  Interprocess  Process 
Commun i cat 1 on  ( IPC)  Primitives ;  January  10.  1983. 
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3.1.2  Standards 

[10]  American  National  Standards  Committee  X3;  American 
National  Dictionary  for  Information  Processing; 
X3/TR-1-77;  September  1977. 

[11]  I CAM  Documentation  Standards;  28  December  1981; 
IDS150120000A. 

[12]  SofTech,  Inc.;  ICAM  Test  Bed  Interim  Standards  and 
Procedures";  February  1982;  ISP620150000. 

[13]  General  Electric  Co.;  IISS  Software  Development 
Guidel ine/Conventions  (Draft);  August  23,  1982. 
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SECTION  4 
REQUIREMENTS 


This  section  includes  functional  and  performance 
requirenents  for  the  MTM.  Zn  addition,  it  defines  the  NTM 
interfaces  to  other  IISS  CPCIs. 

4.1  Computer  Program  Definition 

The  MTM  interfaces  with  IISS  CPCIs,  integrated  and 
non- integrated  application  programs  (APs),  and  host  operating 
systems.  The  NTM  CPC I  will  interface  with  several  IISS 
components.  The  identified  ones  are:  the  Coanuni cat ions  Handler 
APs  (COMM),  the  Coaaon  Data  Model  Request  Processor  (CDMRP),  an 
Operator's  Console,  and  the  User  Interface  (UI). 

4.1.1  System  Capacities 

The  MTM  system  capacity  requirements  are  the  following: 

a.  A  VAX  11/780,  that  runs  the  VMS  Operating  System,  & 
Honeywell  Level  6  running  the  GCOS  MOD  400 
Operating  System,  and  an  IBM  3033  running  CICS 
under  MVS.  The  internal  timing  rates  and  computer 
storage  capacities  will  be  determined  by  the 
particular  host's  configurations  supplied  for  the 
IISS  Test  Bed  [14] . 

b.  One  IISS  Operator's  Console  on  the  VAX*. 

c.  Sufficient  disc  storage  on  all  three  hosts  for  an 
NTM  module,  its  associated  files,  and  a  Message  and 
Error  Log.  Requirements  for  log  archiving  have  not 
yet  been  determined. 

d.  Core  storage  requirements  for  the  NTM  have  not  yet 
been  determined. 


*VAX  is  a  trademark  of  the  Digital  Equipment  Corporation. 
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* 


There  will  be  three  types  of  inputs  to  the  MTM. 

These  are: 

e  inputs  from  an  operator's  console 

e  Messages  and  servioe  requests  from  other 

CPC Is  and  APs 

e  Host  Operating  Systea  responses  and 

Messages . 

The  voluae  of  the  particular  types  of  inputs  has 

not  yet  been  deterained. 

The  initial  testbed  MTM  will: 

e  operate  on  the  VAX  11/780,  the  Honeywell 

Level  6,  and  an  IBM  3055  (Figure  4-1). 

•  support  COMM ,  01 ,  MTR  (the  IISS  Monitor  and 

Operator's  Console  Cluster,  Figure  4-2), 
CDMRP.  and  Test  Application  Clusters  on  the 
VAX. 

e  support  COMM,  Monitor,  and  application 

clusters  on  the  Honeywell  and  the  IBM  (MCMM 
on  the  KL6  and  MRP  on  the  IBM). 


4 . 1 . 2  Interface  Requirements 


Requireaents  placed  on  the  design  of  the  MTM  CPCI  because 
of  its  relationship  to  other  equipaent/coaputer  prograas  are  as 
follows.  The  MTM  CPCI  design  is  constrained  by  the  requirement 
to  operate  in  three  environaents :  a  VAX  11/780.  VMS  environment; 
the  Honeywell  Level  6.  GCOS/MOD  400  environment;  and  the  IBM 
3033,  CICS  (MVS)  environaent.  It  must  also  provide  message 
acceptance  and  delivery  for  the  other  CPCIs  including  the  IISS 
operator.  Figure  4-1  shows  the  relationships  between  the  hosts 
and  other  CPCIs  that  will  exist  when  the  Test  Bed  supports  the 
three  hosts. 


The  requirement  to  support  the  MTM  on  multiple  hosts 
imposes  a  need  for  portability  in  the  MTM  CPCI  design.  These 
portability  considerations  and  existing  vendor  support  for 
FORTRAM  and  COBOL  effected  a  decision  to  use  COBOL  for  the  IISS 
CPCIs.  There  may  be  a  need  to  use  Assembly  Language  routines  to 
implement  host  specific  functions  that  are  not  available  in 
COBOL.  This  will  only  be  done  where  the  COBOL  compiler  does  not 
provide  an  interface  for  host  specific  functions. 
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1.  The  IISS  operator  Interface  will  be  implemented  as  an  IISS 
terminal  or  as  a  separate  console  interface.  It  is  treated 
as  a  separate  entitiy. 

2.  For  the  initial  test  bed,  the  User  Interface  (UI)  will 
reside  on  only  one  host,  the  VAX.  There  will  be  one  UI 
instance  for  each  IISS  terminal  that  is  logged  on. 

3.  The  Communication  components  are  named  to  indicate  the  link 
pair  (i.e.,  COMM  V-H  indicates  the  component  on  the  VAX  that 
communicates  with  the  Honeywell  Level  6). 


Figure  4-1.  IISS  System  External  Interfaces 
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The  Application  Process  Cluster  (APC)  conceptual 
relationship  to  the  other  CPCIs  is  depicted  in  Figure  4-2.  The 
WTM  rectangles  included  inside  the  heavy  black  rectangle  are  the 
MTM's  Message  Processing  Unit  (MPU)  components  for  the 
Application  Process  Clusters  of  the  VAX  host. 

Figure  4-3  focuses  on  the  interface  between  the  MPU 
components  of  the  MTM  and  the  Application  Processes  (APs).  The 
MTM  provides  an  AP  Interface  (API)  called  the  MTM  I/F  Routine  to 
provide  APs  with  the  ability  to  send  messages  to  other  APs  and 
to  MTM  components  in  the  IISS.  IISS  messages  are  delivered  in 
mailboxes  that  are  managed  by  the  MTM.  The  MTM  uses  IPC 
Primitives  [9]  for  its  interprocess  communication  functions. 
These  Primitives  provide  the  process  to  process  functions  of 
mailbox  creation,  mailbox  writes,  mailbox  reads,  waits,  timers, 
and  mailbox  deletion. 

The  AP  Interface  provides  a  set  of  high  level  MTM  calls  for 
use  by  the  AP,  that  are.  in  concept,  similar  to  traditional 
operating  system  calls.  Figure  4-4  contains  a  list  of  these  NTH 
Service  Calls.  A  complete  description  of  the  MTM  calls  is 
contained  in  the  IISS  Programmer's  Guide  [8).  A  set  of  MTM  I/F 
routines  are  linked  to  each  IISS  AP  to  provide  the  integration 
of  the  AP  into  the  IISS  Test  Bed.  The  NTM  interface  requirements 
for  the  NTM  I/F  routines  for  new  APs,  existing  APs,  COMM,  and 
the  UI  are  described  in  the  following  paragraphs.  The  Operator 
Interface  to  the  MTM  requires  a  different  NTM  interface,  and  is 
described  in  Section  4. 1.2. 5. 

4. 1.2.1  WTM  Interface  for  Mew  Applications 

The  NTM  Interface  for  new  IISS  Applications  is  the  set  of 
MTM  Services  described  in  the  IISS  Programmer's  Guide  [8].  The 
AP  uses  the  NTM  service  calls  to  send  and  receive  messages  from 
other  IISS  APs.  The  AP  interfaces  directly  to  the  AP  Interface 
component  of  the  NTM  (Figure  4-5).  The  interfaces  will  be 
implemented  as  a  set  of  NTM  I/F  subroutines  that  will  be  bound 
(linked)  to  the  AP  to  form  the  AP's  runtime  module. 
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Figure  4-3.  NTM/AP  Interfaces 
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Connection  Services 

*  IMITAL  Provide  initiation  services  for  new  APs 

*  TRMNAT  Signal  AP  termination  status 

*  ENDRCY  Signal  end  of  reoovery  processing 

Communication  Services 

*  MS END  Send  a  message 

*  GDSEND  Send  a  guaranteed  delivery  message 

*  I SEND  Send  an  initiation  request 

*  QSEND  Send  a  Queue - Server ' s  reply  message 

*  CHKMSG  Check  for  any  current  messages  (use  RCV  to 

retrieve  messages) 

SETDLT  Specify  delay  condition  for  next  message 

*  SIGERR  Notify  the  NTH  of  an  AP  (non-fatal)  error 
GDACK  Acknowledge  receipt  of  a  guarani  teed  delivery 

message 

MSGACK  Acknowledge  receipt  of  a  message 

*  RCV  Receive  a  message 

*  TSTMOD  Switch  IISS  message  test  mode  on  or  off 
NTH  Requests 

APSTAT  Get  the  status  of  a  specified  AP 

HSTATS  Get  the  status  of  a  specified  host 

*  WHTHST  Request  the  name  of  the  current  host 

WHATAC  Request  the  name  of  the  current  AP  Cluster 

WKONCA  Request  "wake-up"  on  specified  AP  Cluster 

aval labi 1 ity 

ACSTAT  Get  the  status  of  a  specified  AP  Cluster 
SIGABT  Signal  to  NTM  to  abort  an  AP 

PRSTAT  Get  the  status  of  one  or  more  paired  messages 

GDSTAT  Get  the  status  of  one  or  more  guaranteed 

delivery  messages 

*  GETUSR  Get  the  name  of  the  original  source  of  a 

given  chain  of  AP's 

Privileged  Services 

*  INICOM  Provide  initiation  services  for  the  COMM  APs 

*  1NITEX  Provide  initiation  services  for  UI  AP 

*  LOGON  Send  IISS  user  Logon  information  to  NTM 

*  LOGOFF  Send  IISS  user  Logoff  information  to  NTM 

*  TRMNAX  Signal  Comm  AP  Termination  Status 

*  CHGROL  Change  the  user's  role  during  a  session 

Figure  4-4.  NTM  Service  Calls 
*  Services  available  in  Release  2.0 
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1.  In  implementation,  APs  that  can  process  NTH  commands 
(i.e.,  shutdown)  will  have  three  input  mailboxes.  The 
second  input  mailbox  will  be  used  to  receive  these  high 
priority  unsolicited  messages  from  the  NTM  while  the 
third  is  reserved  for  Message  Acknowledgements  from  the 
HTM. 


Figure  4-5.  The  AP's  Interface 
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An  AP  that  is  to  be  integrated  into  the  IISS  and  use  the 
message  services  of  the  NTH  must  be  written  according  to  a 
format  that  includes  NTM  Initiation  ( INITAL)  and  termination 
(TRMNAT)  calls  at  the  beginning  and  the  end  of  its  Procedure 
Division  (COBOL)  as  shown  in  Figure  4-6.  The  CALL  "INITAL"  and 
CALL  "TRMNAT,"  respectively,  provide  the  IISS  connection  and 
termination  service.  Communication  between  IISS  APs  is 
accomplished  by  using  the  NTM  calls  that  are  described  in 
Section  5  of  the  IISS  Programmer's  Guide  [8].  For  example,  the 
CALL  "NSEND"  USING  ....  will  cause  a  program's  message  to  be 
delivered  to  the  NTM  for  routing.  The  NTM  routes  the  messages 
through  the  IISS  to  the  destination  AP.  The  destination  AP 
receives  its  messages  by  using  the  NTM  "RCV"  call. 

4. 1.2. 2  NTM  Interface  for  Existing  Applications 

An  NTM  interface  for  existing  ICAM  applications  (i.e.,  MCMM 
and  MRP)  will  be  designed  to  minimize  any  required  changes  to 
the  APs  for  interfacing.  The  NTM  interface  for  existing  APs: 

a.  Shall  include  an  initiation  routine  'INI - '  that 

may  be  specific  to  each  application.  It  will 
provide  NTM  connection  logic  for  the  AP. 

b.  Will,  in  some  manner,  take  I/O  from  the  program's 
DISPLAY  call  and  formulate  an  NTM  message  from  the 
data  and  deliver  it  to  a  User  Interface  AP  (UI)  for 
display  on  a  non-local  terminal  request. 

c.  Will  take  and  deliver  a  message  from  a  UI  for  the 
application  and  unpack  the  received  data  to  return 
to  the  program  on  its  CALL  ACCEPT. 

d.  Shall  include  a  termination  routine  “TRM - "  that 

will  disconnect  the  AP  from  the  NTM. 


Initial  research  into  the  MCMM  and  MRP  cases  indicate  that 
a  generic  NTM  interface  will  not  be  possible  for  them. 


DS  620142000 
1  November  1985 


AP  PROGRAM 

PROCEDURE  DIVISION. 

CALL  "INITAL”  USING  BUFFER. 

BUFFER-SIZE. 

SYSTEM- STATE . 

RET-CODE . 

AP  CODE:  can  include  NTM  calls  that  are 

described  in  the  IISS  Programmer '  s 
guide  [8]  to  communicate  with  the 
IISS. 

•  •  • 

CALL  "TRMNAT"  USING  TERMINATION-STATUS.* 

‘CALL  "TRMNAT"  is  the  last  statement  in  the  AP. 

Figure  4-6.  IISS  AP-COBOL  Procedure  Division  Structure 
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4. 1.2. 5  MTH  Interface  to  the  COM  AP's 

The  Commun i o&t i on  (or  COMM)  AP  cluster  will  support  &  OOMH 
application  process  for  each  host  connection.  They  are  handled 
in  a  slightly  different  Banner  fron  other  AP's.  These 
differences  are  noted  below.  The  OOMM  AP  cluster  on  the  VAX  host 
is  conceptually  represented  in  Figure  4-7.  These  OOMM  AP's  are 
not  part  of  the  MTH. 

Because  the  COMM  APs  perforn  many  of  the  AP  Interface 
functions  directly,  they  will  have  only  a  selected  set  of  AP 
Interface  routines  bound  to  thee. 

The  MTH  Interface  for  the  COMM  APs  is  the  following: 

Services 

a.  COMM  will  use  the  MTH  initiation  routine. 

CALL  " INICOM"  US IMG  event-block. 

input-aai lbox-naae . 
cluster-hot-mailbox  naae, 
cluster-cold-mailbox  name, 
status . 

INICOM  will 

e  create  the  COMM's  input  mailbox 

•  establish  an  IISS  exception  handler  for  COMM 

e  return  the  names  of  the  COMM  AP's  input 

mailbox  and  the  names  of  the  two  cluster 
mai lboxes . 

b.  COMM-NTM  Communication  -  The  COMM  AP's  will  use, 
directly,  the  IPC  primitives,  to  send  and  receive 
messages  from  the  NTM.  On  receiving  a  message  from 
the  NTM  it  will  inspect  the  destination  AP  name  in 
the  header  to  determine  whether  the  message  is  for 
it  or  to  be  sent  to  its  remote  host.  Messages  for 
COMM  and  the  COMM-NTM  protocol  are  given  in  Figure 
4-8. 

c.  COMM  will  use  the  NTM  termination  routine.  "TRMNAT" 
[8],  to  end  its  execution.  It  calls  "TRMNAT"  on  the 
receipt  of  a  "TR"  message  from  the  NT Ms  MONITOR  AP . 
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local  area  net  link  network  link 

to  Honeywell  Level  6  to  IBM 


Figure  4-7.  The  COMM  AP/HTM  Interface 
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Message  to  a  COMK  AP 
froa  the  MTM's  Monitor  AP 

Message  Types 

a)  "SL"  (start  link) 


b)  *SD*  (shutdown  link) 

c)  "TR" 

d) 


Figure  4-8.  COMM 


Action  by  the  COMM  AP 


COMM  atteapts  to  start  the 
link  to  its  reaote  host. 
Responds  with  "LA"  -  link 
active  aessage  or  "LF"  - 
link  fail 


COMM  shuts  down  (stops 
listening  to)  reaote  host 
and  responds  with  "LF” 


COMM  calls  the  NTM 
teraination  routine 
"TRMNAT"  to  end  execution 


A  COMM  aay  send  the 
following  unsolicited 
messages  to  the  NTM's 
MONITOR  AP. 

"RE",  recoverable  error 
with  five  character  error 
code  in  the  data  field 

"LF" ,  a  link  fail  aessage 


AP/NTM  Protocol 
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4. 1.2. 4  NTM  Inlerfaoe  lo  the  User  Interface  (UI) 

The  User  Interfaoe  (UI)  is  the  application  process  that 
interfaces  to  the  IISS  user  terminals.  Initially,  there  will  be 
one  UI  per  IISS  terminal  with  a  number  of  UIs  associated  with 
one  work  station.  Conceptually,  the  NTM-UI  Interface  is  depicted 
in  Figure  4-9. 

The  connection  protocol  of  these  terminals  causes  this  APC 
to  be  handled  in  a  slightly  different  manner  than  other  APCs. 
However,  this  difference  is  transparent  to  the  UI  APs.  The  UI 
(AP)  Interface  and  the  NTM  protocols  handle  this  special 
requirement  by  providing  the  necessary  NTM  connection  logic  on 
the  UI's  initiation  call,  CALL  "1NITEX"  [8].  The  services  of 
INITEX  are  described  below.  This  implementation  is  specific  for 
the  VAX  under  VMS. 

UI-NTM  Initiation  Service  (INITEX) 

The  UI  requires  an  "external "  initiation  connection  service 
that  is  supplied  by  the  routine  "INITEX."  This  allows  a  user  to 
logon  to  an  IISS  terminal  and  initiate  a  UI  process  from  a  logon 
command  file.  The  UI  must  connect  to  the  NTM,  rather  than  the 
NTM  Initiating  the  UI  as  in  the  normal  IISS  process  initiation 
procedure.  External  connection  is  required  in  light  of  the  way 
that  the  UI  will  manage  the  terminals.  INITEX  performs  the 
following  initiation  functions  for  the  UI . 

1.  Sends  an  "I'm  alive"  message  that  contains  the  UI's 
operating  system  given  process  name  to  the  UI's 
NTM. 

2.  Creates  the  UI's  input  mailboxes. 

3.  Establishes  the  IISS  exception  handler  for  the  UI . 

4.  Saves  the  UI's  buffer  address  and  buffer  size  for 
later  message  services. 

5.  Returns  to  the  UI  with  the  status  of  the 
initiation. 

The  UI  and  Logical -Channels 


A  UI  will  manage  communications  between  the  NTM  and  any 
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1.  UI  represents  the  01  code. 

01  (AP)  Interface  is  the  special  AP  Interface  for  the  01. 
The  01  code  is  bound  with  the  01  (AP)  Interface. 

2.  The  01 -1  Mailbox  is  the  Input  sail box  for  the  first 
instance  of  the  01 . 

3.  These  represent  the  work  stations  high  and  low  priority 
aailboxes . 

4.  The  MPO  is  the  Message  Processing  Onit  of  the  NTM. 


Figure  4-9.  NTM -01  Interface 
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terainal s  connected  to  it  (initially  only  one  terainal  will  be 
supported  by  a  01  AP).  The  logical  channel  specifier  provides  a 
aechanisa  for  the  UI  to  aap  aessages  to  terainal s,  or  to 
aultiple  screens  on  a  given  terainal.  The  UI  cam  aanage  the 
aapping  between  aessages  and  screens  or  terainal s  by  aaintaining 
a  table  that  carries  the  current  channel  assignaents  for  a 
terainal  or  screen  and  using  the  channel  nuabers  as  suggested  in 
[83. 


The  requireaent  for  an  AP  to  be  able  to  send  an  unsolicited 
fora  to  a  terainal  can  be  supported  by  the  use  of  a  specified 
channel  for  UI  unsolicited  aessages  (channel  0  is  being  reserved 
for  these  unsolicited  aessages  for  single-terainal  UIs). 

Multi terainal  UIs  cam  also  be  supported  by  the  NTH  in  the 
future  with  a  slight  nodification  to  the  INITEX  routine.  The  UI 
will  assign  blocks  of  channel  specifiers  to  a  terainal  when  the 
terainal  logs  on.  The  NTM  will  need  to  know  the  channel  nuabers 
associated  with  a  logon,  and  will  provide  a  aessage  foraat  for 
this  data  when  aulti terainal  UIs  are  developed. 

UI-HTM  Interface  Prograaaing  Conventions 


The  UI  aust  use  the  following  guidelines  to  coaaunicate 
successfully  in  the  IISS  Test  Bed. 

1.  It  aust  be  bound  with  the  UI  (AP)  Interface 
supplied  by  the  NTM. 

2.  It  aust  initiate  coaauni cat  ions  with  the  NTM  with  a 
'CALL  "INITEX"  USING... 

3.  It  must  support  asynchronously  received 
(unsolicited)  aessages  using  CALL  "RCV"  or  CALL 
"CHKMSG"  and  CALL  "RCV"  at  regular  intervals. 

4.  It  must  handle  "shutdown"  aessages.  including 
shutdown  pending,  cancel  shutdown,  and  its  own 
shutdown  procedures . 

5.  If  the  IISS  is  in  a  recovery  or  down  state,  the  UIs 
will  get  a  "connection-failure-reason”  status 
return  on  the  CALL  "INITEX."  It  should  infora  the 
terainal  of  the  state  of  the  IISS  and  provide  a 
logoff  or  local  aode  capability  to  the  user. 
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6.  It  Bust  use  the  RTM  Service  Calls  [8]  to 
communicate  with  other  IISS  APs. 

7.  It  should  terminate  with  the  NTH  call,  “TRHNAT" . 


4. 1.2. 5  KTM  Interface  to  the  IISS  Operator 

The  KTM  shall  interface  to  an  IISS  Operator's  Console. 
Initially,  the  interface  will  exist  only  on  the  VAX  and  will  be 
implemented  as  a  direct  link  from  the  operator '6  console  to  the 
MTM's  Monitor  AP  (Figure  4-10).  An  early  enhancement  will  be  an 
IISS  Operator's  Interface  through  a  01  to  enable  the  use  of 
forms  and  screen  displays  by  the  IISS  Operator. 

a.  The  initial  test  bed  shall  support  the  following 

IISS  Operator  Commands  during  IISS  operation. 

1.  Start  IISS 

2.  Start  APC 

3.  Start  Link 

4 .  Shutdown  APC 

5.  Shutdown  IISS 

6.  Cancel  IISS  Shutdown 

7.  Display  Active  APs 

8.  Display  IISS  Status 

9.  Enable  SIGERR  Messages 

10.  Disable  SIGERR  Messages 


The  MONITOR  shall  provide  prompts  to  the  operator  to  obtain 
the  data  required  for  each  command.  For  example,  the  following 
is  the  START  LINK  scenario  on  the  VAX. 

>  SL  Operator's  Entry 

Enter  Link  ID:  Monitor  Prompt 

>  VH  Operator ' s  Entry 

(Terminal  Locked  out  during  command  Execution) 

COMM  LINK  VH  IS  ACTIVE. 

>  (a  new  command  may  now  be  entered) 

b.  NTM  status  information  sent  to  the  MONITOR  AP  from  any 
of  the  MPU's  that  may  require  an  operator's  action 
shall  be  displayed  on  the  operator's  console. 

c.  For  the  initial  test  bed,  the  IISS  is  started  by  a 
START  IISS  command  entered  by  an  operator  on  each  IISS 
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host.  The  START  IISS  coaaand  will  initiate  a  coaaand 
file  that  starts  the  MONITOR  AP  on  each  host.  The 
MONITOR  APs  then  startup  the  other  NTM  nodules  and 
A PCs  on  their  hosts  and  cooperate  to  connect  the  other 
IISS  hosts  to  conplete  the  startup. 

4.1.3  Internal NTM  Interfaces 


Three  oonponents  (Monitor,  MPO,  and  AP  Interface) 
conaunicate  among  thenselves  through  mailboxes  via  well  defined 
aessages.  These  nessages  have  been  defined  by  type  and  are 
thoroughly  defined  in  Appendix  E.  Each  aessage  carries  a  header 
and  an  optional  data  portion.  The  header  provides  the  essential 
processing  inforaation  needed  by  the  destination  coaponent.  The 
data  portion  is  reserved  for  6pecifio  backup  inforaation 
pertinent  to  the  relevant  aessage  type. 


i 


Field  Naae  Field  Size  Field  ID 


Header  Foraat  Indicator 

X 

HDR-HDRFMT 

Header  Length 

X(3) 

HDR-HDRLEN 

Data  Length 

X(4) 

HDR-DATLEN 

Binary /Native  Flag 

X 

HDR-BINNAT 

Message  Priority 

X 

HDR-MSGPRY 

Message  Type 

X(2) 

HDR-MSGTYP 

AP  Naae  (Destination) 

X(10) 

MD-APNAME 

Instance  (Destination) 

X(2) 

MD-INSTNC 

APC  Naae  (Destination) 

X(3) 

MD-APCNME 

AP  Naae  (Source) 

X(10) 

MS-APNAME 

Instance  (Source) 

X(2) 

MS-INSTNC 

APC  Naae  (Source) 

X(  3) 

MS-APCNME 

Message  Serial  Humber 

X(7) 

HDR-MSGSN 

Processing  Code 

X 

HDR-PROCDE 

Message  Category 

X 

HDR-MSGCAT 

AP  Priority 

X 

HDR-APPRTY 

Integrity  Check  Flag 

X 

HDR-INTCHK 

Log  Requireaent 

X 

HDR-LOGREQ 

Statistics  Collection  Flag 

X 

HDR-STATCO 

Test  Flag 

X 

HDR-TSTFLG 

Delay  Trigger  Flag 

X 

HDR-DELTRG 

Delay  Tiae  Trigger 

X(  15) 

HDR-TRGTIM 

Delay  Trigger  Condition 

X 

HDR-TRGCON 

Original  Source 

X(  15  ) 

HDR-ORGSRC 

Logical  Channel  ID 

X(  3) 

HDR-CHANID 

Continuation  Indicator 

X 

HDR-CONIND 

Figure  4-11.  Header  Format 
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4. 1.3.1  Message  Header 

The  message  header  carries  the  relevant  information  about 
the  message  throughout  the  NTH.  The  header  is  formatted  by  the 
AP  Interface  at  the  message  source  AP.  The  MPU  fills  in  the 
field  values  it  is  responsible  for  and  performs  the  integrity 
checks  on  the  other  header  fields.  The  completed  header  stays 
with  the  message  until  it  reaches  its  destination.  The  Header 
Format  is  shown  in  Figure  4-11.  Each  field  is  defined  below. 


Field  Name 

Field  Value 

Supplied  By 

Field  Description 

Header  Format 

AP  Interface .  MPU 

Identifies  the 

Indicator 

or  Monitor  AP 
(depending  upon 
the  source  of  the 
message) 

particular  format 
of  the  given  message 
header.  For  the  test 
bed  there  is  only  one 
format  although  future 
enhancements 
may  require  other 
formats .  The  value 
contained  in  this 
field  maps  to 
its  definition  in 
the  Data  Division. 

Header  Length 

AP  Interface,  MPU 
or  Monitor  AP 
(based  on  Header 
Format) 

Identifies  the  length 
of  the  given  header 
format.  The  value 
is  given  as  number  of 
bytes . 

Data  Length 

Message  Source  AP 
(may  be  any  AP  on 
the  IISS  including 
Monitor  and  an  MPU) 

Identifies  the  length 
of  the  data 
portion  of  the 
message.  The  value 
is  given  as  number  of 
bytes . 

Binary/Native 

Flag 


Message  Source  AP 
(or  default) 


Indicates  whether  the 
data  portion  of  the 
of  the  message  is 
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Field  Name 

Field  Value 

Supplied  Bv 

Field  Description 

encoded  in  binary  or 
native  mode.  The 
default  value  on  any 
message  is  always  to 
native  mode. 

Message 

Priority 

Source  MPU  (based 
on  Message  Category) 

Identifies  the 
priority  of  the 
message.  The  value  is 
obtained  by  the  MPU 
from  the  Message 
Category  Table. 

Message  Type 
can  only  be 
by  the  NTM. 

Message  Source  AP 
(Note:  This  value 
cannot  be  derived 
-  it  can  only  be 
provided  by  the 
message  source) 

Identifies  the  nature 
of  the  message. 

See  Section  10.5  for 
the  specific  message 
types  used  by  the  NTM. 
The  source  AP  is  free 
to  choose  its  own 
message  types  as 
defined  by  AP-AP 
protocol . 

AP  Name 
(Destination) 

Message  Source  AP 
(Note:  This  value 
cannot  be  derived, 
it  can  only  be  pro¬ 
vided  by  the  message 
source. ) 

Identifies  the 
Application  Pro¬ 
cess  to  which  the 
message  is  directed. 

Instance 

(Destination) 

(Destination) 

AP  Interface  (Note: 
this  field  is  op¬ 
tional,  as  a  desti¬ 
nation  instance  may 
not  exist  when 
message  is  sent.) 

Identifies  the 
specific 

occurrence  of  the  Des¬ 
tination  AP  to  which 
the  message  is  the 
directed,  when  known. 

APC  Name 
(Destination) 

Source  MPU 

Identifies  the  AP 
Cluster  upon  which 
the  destination  AP 
resides.  This  value  is 
generally  obtained 
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Field  Value 
Field  Name _ Supplied  By 


AP  Name  (Source)  AP  Interface 


Instance  AP  Interface 

(Source) 


A PC  Nave  AP  Interface 

(Source) 

Message  Source  MPU 

Serial  • 


Field  Description 
frov  the  AP 

Xnforvation  Table.  The 
exceptions  are  in  the 
cases  where: 

a.  The  Destination  AP 
is  an  IISS  Component 
(whose  A PC  Names  are 
known  to  all  MPU's) 

b.  The  Destination  AP 
is  an  MPU.  In  this 
case,  the  APC  Name  is 
always  the  last  three 
characters  of  the 
MPU's  Name. 

c.  The  source  AP  has 
received  a  message 
from  the  destination 
and  therefore  knows 
the  destination  APC. 

The  source  of  the 
given  message. 

The  specific 
occurrence  of  the 
message  source  AP. 

The  APC  upon  which  the 
source  AP  resides  - 

A  unique  APC  number 
that ,  when 

concatenated  with  the 
source  APC 
name,  provides  a 
unique  message 
identifier  for  the 
given  message  through¬ 
out  the  IISS. 
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Field  N ame 


Processing  Code 


Message  Category 


AP  Priority 


Integrity  Check 
Flag 


Log  Requirement 


Field  Value 

Supplied  By _ Field  Description 


AP  Interface  or 
Default 


AP  Interface  (de¬ 
rived  from  Call 
'SEND'  Parameters) 


Source  MPU 


Message  Source  AP 
or  Default 


Source  MPU 


Identifies  whether  the 
given  header  is  "used” 
or  new.  If  "used-  it 
is  assumed  to  be 
correct  and  does  not 
require  integrity 
checking.  The  default 
is  always  set  to  "0" 
(new) . 

Defines  special 
processing 

to  be  performed  by  the 
MPU.  See  Sections 
4 . 5 . 3 . 1  and  Append i x  E 
for  details. 

Identifies  the 
relative  priority  of 
the  source  AP.  Its 
value  is  obtained  from 
the  AP  Characteristics 
Table. 

Indicates  whether  an 
integrity  check  is  to 
be  performed  on  the 
data  portion  of  the 
message.  The  default 
is  always  set  to  "0" 
(No)  . 

Indicates  whether  the 
message  is  to  be 
logged  at  every  MPU  it 
arrives  at.  The  value 
is  obtained  from  the 
Message  Category 
Table . 


Statistics 
Collection  Flag 


Source  MPU 


Indicates  whether 

statistics  arc 

to  be  collected  on  the 
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Field  Name 


Test  Flag 


Delay  Trigger 
Flag 


Delay  Trigger 
Time 


Field  Value 
Supplied  By 


Message  Source  AP 


Message  Source  AP 
or  Default 


Message  Source  AP 
or  Default 


Field  Description 

message.  The  value  is 
obtained  from  the 
Message  Category 
Table . 

Indicates  whether  the 
source  AP  is  operating 
in  regular  or  test 
mode.  This  is 
set/reset  by  the  User 
Interface.  If  set, 
the  UI  is  running  in 
“System  Mode"  and  will 
receive  all 
asynchronous  error 
messages  from  the 
AP  and  will  display 
them  on  the  message 
line.  If  the  test 
mode  flag  is  reset, 
the  asynchronous  error 
messages  are  only 
logged  in  the  error 
log  and  not  displayed 
on  the  terminal . 

Defines  when  the  Flag 
message  is  to  be 
delivered  to  its 
destination  AP.  The 
default  is  always  set 
to  "0"  (No  Delay). 

Identifies  the  time 
constraint  associated 
with  the  delay 
trigger.  Where  a  time 
constraint  is 
not  applicable,  this 
field  will  be  filled 
with  blanks  (default). 
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FieldH&ae 


Delay  Trigger 
Condition 


Original  Source 


Logical  Channel 
ID 


Field  Value 

Supplied  By _ Field  Description 

Message  Source  AP  Identifies  the  condi - 

or  Default  tional  constraint 

associated  with  the 
delay  trigger.  Where 
this  constraint  i6  not 
applicable,  the  field 
will  be  filled  with 
blanks  (default). 

AP  Interface  Identifies  the 

Original  Souroe  (root 
AP)  of  the  Message 

Source  AP.  This  value 
is  generally  obtained 
fron  the  AP  Status 
Table.  The  exception 
is  for  Messages 
conforalng  to  Category 
F.  In  that 
case,  the  value  is 
obtained  fron  the 
corresponding  field  of 
the  relevant  Category 
B,  D.  or  J  Message. 

See  Appendix  E  for 
details  on  the  use  of 
Category. 

On  Messages  conforning 
to  Category  B,  D.  or  J 
the  logical  channel  ID 
identifies  the  channel 
upon  which  the  reply 
Message  is  to  be 
returned.  (Note:  the 
channel  will  either  be 
source  specified  or 
defaulted  to  the 
channel  under  which 
the  source  AP  was  ini¬ 
tiated).  On  Category  H 
Messages,  this  field 
will  contain  the 


Original  source  AP 
AP  or  the  AP  Inter¬ 
face 
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Field  Value 

Field  Marne _ Supplied  By _ Field  Description 

channel  ID  under  which 
the  target  AP  is  to  be 
initiated.  On  Category 
F  messages,  this  field 
will  contain  the 
channel  ID  specified 
in  the  original  B,  D. 
or  J  message  (i.e., 
the  Field  request 
message  to  which  the 
reply  is  being  made). 
For  A,  C,  E  or  G 
messages,  the  channel 
ID  value  will  be  the 
one  under  which  the 
message's  source  AP 
was  initiated. 

The  source  AP's 
channel  ID  is  obtained 
from  the  AP  status 
table.  See  Appendix  E 
for  details  on  the  use 
of  Category. 

Continuation  AP  Interface  Identifies  whether  the 

Indicator  message  is  continued 

or  stand  alone. 

4. 1.3. 2  The  Monitor  AP 

The  Monitor  AP  (Figure  4-12)  is  a  component  of  the  NTH 
that  resides  on  each  I1SS  host  on  a  cluster  that  is  dedicated  to 
this  AP.  It  is  an  IISS  Application  Process  whose  functions  are 
illustrated  in  the  node  tree  in  Figure  4-12. 
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Figure  4-12.  Monitor  AP  Functions 


4. 1.5. 2.1  Accept  Commands  fron  the  IISS  Operator 

The  commands  that  will  be  accepted  fron  the  Operator's 

console  in  the  initial  Test  Bed  are  listed  in  4. 1.2. 5. 

4. 1.5. 2. 2  Service  Connands  fron  the  IISS  Operator 

The  processing  that  is  provided  on  each  of  the  supported 

IISS  operator's  connands  is  described  below. 

START  IISS  ON  VAX: 

1.  Monitor  AP  is  spawned  as  a  result  of  the  start  IISS 
conmand  fron  the  operator. 

2.  Monitor  reads  its  startup  file  to  deternine  the  current 
Sysgen  Parameters.  Among  the  parameters  is  the  current 
table  configuration.  Monitor  conpares  the  current 
Operating  configuration  ID  to  its  old  value  and  sets  a 
flag  that  indicates  whether  tables  and  local  files  are 
up-to-date . 

5.  Monitor  creates  its  input  n&ilbox. 

4.  It  spawns  it's  APC's  MPU. 
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5.  It  waits  for  a  “Table  Status  Request"  message  from  the 
spawned  MPO. 

6.  On  receipt  of  the  "Table  Status  Request"  message,  the 
Monitor  always  sends  a  "Tables  OK"  message  to  its  MPO  and 
then  waits  for  an  "I'm  Alive"  message  from  the  MPO.  The 
Monitor  MPO's  tables  will  be  started  up  using  the  tables 
that  they  had  when  they  were  shut  down.  If  changes  have 
been  made  in  the  system  data  stored  in  the  COM  while  the 
MPO  was  shutdown,  the  tables  may  be  wrong,  but  at  least 
adequate  to  startup.  After  the  CDM  cluster  is  up,  the 
tables  cam  be  updated  if  neoessary.  Mote:  The  table  logic 
associated  with  the  storage  of  tables  in  the  CDM  was  not 
implemented  in  Release  2.0. 

7.  On  receipt  of  the  "I'm  Alive"  message,  the  Monitor  updates 
the  Monitor's  A PC  status  in  the  APC  Status  Table  to 
"cluster-up" . 

6.  Monitor  sends  the  active  APC  a  "Host  Active"  message  to 
indicate  that  the  APC's  startup  is  complete  and  it's 
normal  processing  can  begin. 

9.  The  Monitor  AP  spawns  the  CDM  cluster  by  sending  a  start 
APC'  message  to  its  MPD  which  will  now  spawn  the  CDM  MPU. 
It  now  repeats  steps  5-7  for  the  CDM  cluster,  except  it 
will  now  send  the  correct  table  status  to  the  CDM  cluster 
("Tables  OK"  to  indicate  that  there  have  been  no  changes 
in  the  system  database  definitions  of  the  tables  so  the 
tables  being  used  at  shutdown  are  ok,  or  "Tables  Obsolete” 
to  indicate  that  changes  have  been  made  and  that  new 
tables  should  be  called  for.  Note:  The  logic  for  storage 
of  table  information  in  the  CDM  was  not  implemented  in 
Release  2.0. ) 

10.  If  the  current  table  configuration  ID  is  not  equal  to  the 
old  ID,  the  Monitor  AP  sends  requests  for  new  tables  to 
the  CDMRP  and  then  sends  a  "Rebuild  Table"  message  to  its 
MPU  so  that  the  MPU  can  rebuild  the  tables. 

11.  If  any  of  the  above  steps  encounters  an  unrecoverable 
error,  the  Monitor  AP  will  send  a  message  to  the  operator 
and  end  execution. 

12.  The  Monitor,  now  with  correct  tables,  sends  a  START  APC' 
message  to  its  MPU  to  startup  the  UI  cluster  (then,  does 
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Steps  5-8  again,  sending  the  correct  table  status).  If 
this  fails,  the  Monitor  AP  informs  the  operator  and 
terminates  the  IISS. 

13.  Other  clusters.  Indicated  by  the  Monitor  AP's  tables,  are 
started  by  a  "start  APC”  message  followed  by  Steps  5-8. 
This  time,  however,  a  failure  only  causes  a  status  message 
to  be  sent  to  the  operator  and  an  update  to  the  Monitor 
AP's  Status  Tables. 

14.  The  Monitor  AP  next  6tart6  the  Network  Communications  by 
sending  Initiate  COMM  AP  messages  to  the  COMM  cluster. 
These  are  followed  by  Start  Link  messages  to  the  COMM  APs. 
The  link  status  message  will  be  received  and  handled  as 
part  of  Monitor's  regular  processing  operations. 

15.  The  Monitor  AP  updates  its  Host  table  entry  to  Active. 
"Host  Available  Messages"  that  include  the  host  active  APC 
names  will  be  sent  to  any  remote  hosts  onoe  a  link  is 
established  with  the  VAX. 

START  IISS  ON  NON-VAX  HOSTS: 

1.  It  is  assumed  that  non-VAX  startups  will  be  initiated  at 
the  system  operator '6  console. 

2.  Steps  1-6  of  the  VAX  startup  are  performed. 

3.  The  link  to  the  VAX  is  started  as  in  Step  14  with  only  one 
difference:  the  Monitor  AP  will  always  send  a  "Tables  OK" 
message  to  the  COMM  MPU.  If  the  start  of  the  link  to  the 
VAX  is  unsuccessful,  the  non-VAX  startup  has  failed,  a 
status  message  is  sent  to  the  non-VAX  console,  and  the 
host  startup  is  terminated. 

4.  If  the  link  to  the  VAX  is  successful  and  the  Non-VAX 
MONITOR  receives  the  "VAX  Host  Available”  message  sent  in 
step  15  above,  the  Non-VAX  MONITOR  AP  rebuilds  its  tables 
and.  if  necessary,  sends  rebuild  table  messages  to  the 
MONITOR  and  COMM  MPUs .  (The  MONITOR  AP  and  the  MPUs  use 
of  the  off-host  table  rebuild  protocol  is  TBD) . 

5.  If  host  tables  were  rebuilt  from  the  CDM,  the  MONITOR  AP 
waits  for  "Table  Rebuilt”  Status  messages  from  the  COMM 
and  MONITOR  AP  MPUs. 

If  table  processing  fails,  the  MONITOR  AP  informs  the 
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operator  and  terminates  the  IISS  component  on  the  non-VAX 
host. 

6.  When  the  non-VAX  MTM  tables  are  built,  the  local  APCs  to 
be  initiated  are  started  as  they  are  on  the  VAX.  An 
initiation  error  here  is  not  a  fatal  IISS  error. 

7.  The  remaining  network  links  are  started  and  "Host 
Available"  messages  are  sent  as  in  Step  15  of  the  VAX 
Startup. 


START  A PC  (VAX  only,  while  IISS  is  running): 

1.  Monitor  prompts  the  Operator  for  the  A PC  name. 

2.  The  operator  enters  an  A PC  selection. 

3.  If  the  selection  is  valid,  the  Monitor  AP  determines  the 
host  location  of  the  APC. 

4.  If  the  APC  is  off-host  and  the  destination  host  is 
running,  the  MONITOR  AP  sends  a  ‘START  APC"  command  to  the 
correct  off -host  Monitor  AP  MPU.  If  the  host  is  not 
active,  the  Monitor  AP  sends  a  "APC's  Host  is  not  active" 
message  to  the  operator. 

5.  If  the  APC  is  on-host,  the  Monitor  AP  sends  a  'START  APC' 
command  to  its  MPU  and  performs  the  protocol  of  Steps  5-8 
in  the  IISS  Startup  Procedure  (p.  4-27). 


START  LINK  (VAX  only  while  IISS  is  running): 

1.  Monitor  prompts  the  Operator  for  a  link  ID. 

2.  The  operator  enters  a  link  ID. 

3.  If  the  selection  is  valid,  the  monitor  AP  checks  to  see  if 
the  COMM  APC  is  available,  if  it  is  not: 

3a.  It  sends  a  "Start  COMM  APC"  message  to  its  MPU 

3b.  The  Monitor  checks  the  status  of  the  COMM  AP. 

If  the  COMM  AP  is  not  active,  the  MONITOR  then 
sends  a  "Start  Comm  AP"  Message  followed  by  a 
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"Start  Link”  message  to  the  COMM  AP.  If  the  COMM 
AP  is  active,  only  the  "Start  Link"  message  is 
sent. 

3d.  Upon  receiving  the  link  status  from  the  COMM  AP, 

the  MONITOR  AP  displays  the  new  link  status  to  the 
operator . 

If  the  COMM  APC  is  available.  Steps  3b,  3c,  and  3d  are 
performed . 


SHUTDOWN  APC  Con  VAX  only); 

1.  The  MONITOR  prompts  the  Operator  for  the  APC  name. 

2.  The  operator  enters  the  APC  name. 

3.  If  the  selection  is  valid,  the  operator  sends  a  "SHUTDOWN 
APC"  message  to  the  APC. 

4.  On  a  Shutdown  Status”  message  from  a  VAX  APC  or  an  "Update 
APC  Table"  message  from  a  non-VAX  Monitor  AP  if  the  APC 
was  off  host,  the  Monitor  AP  sends  a  status  update  message 
to  the  operator. 


SHUTDOWN  IISS  Con  VAX  only): 

1.  The  MONITOR  AP  requests  the  tine  until  shutdown  from  the 
operator . 

2.  If  the  time  until  shutdown  is  not  immediate,  the  MONITOR 
AP  sends  "Shutdown  Pending”  status  message  to  the  UIs  at 
one  minute  intervals.  If  shutdown  is  immediate  step  3  is 
ignored. 

3.  Before  the  time  until  shutdown  expires,  the  MONITOR  AP 
will  accept  only  "CANCEL  IISS  SHUTDOWN,"  DISPLAY  IISS 
STATUS",  "HELP",  or  "DISPLAY  ACTIVE  APs"  commands  from  the 
operator . 

4.  When  the  time  until  shutdown  has  elapsed,  the  VAX  MONITOR 
AP  sends  "SHUTDOWN  IISS"  messages  to  the  non-VAX  MONITOR 
APs,  sets  its  status  to  "IISS  Shutting  Down”,  and  sends 
"SHUTDOWN  APC"  messages  to  each  active  on-host 
non-component  APC. 
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5.  Each  non-VAX  Monitor  AP  on  receiving  the  Shutdown  Connand 
sends  "Shutdown  A PC"  messages  to  its  APCs  (exoept  COMM) . 
When  all  of  the  APC's  "APC  Shutdown"  messages  have  been 
received,  the  non-VAX  Monitor  AP  sends  a  message  to  the 
VAX  Monitor  AP  announcing  the  host  shutdown,  then  shuts 
down  COMM,  its  MPO  and  finally  itself. 

6.  When  the  VAX  Monitor  AP  has  reoeived  all  "IISS  host 
shutdown"  and  local  "APC  Shutdown"  messages,  or  has 
timed-out  on  any  of  these,  it  shuts  down  the  VAX  COMM 
AP's,  the  COMM  APC,  its  MPO,  sends  a  final  status  message 
to  the  operator,  saves  its  tables,  closes  its  files,  and 
ends  execution. 

7.  Throughout  the  shutdown  IISS  process,  the  Status  Messages 
from  off -host  and  local  APC  shutdowns  are  sent  to  the 
operator . 


SHUTDOWN  HOST  Con  VAX  only): 

1.  The  Monitor  AP  displays  the  active  host  names  (not  VAX*) 
to  the  operator. 

2.  The  operator  selects  the  desired  host. 

3.  The  VAX  Monitor  AP  sends  a  "Shutdown  Host”  message  to  the 
off -VAX  Monitor  AP. 

4.  Each  non-VAX  Monitor  AP,  on  receiving  the  Shutdown  Command 
sends  Shutdown  APC  messages  to  its  APCs  (except  COMM). 

When  all  of  the  APC's  "APC  Shutdown"  messages  have  been 
received,  the  non-VAX  Monitor  AP  sends  a  message  to  the 
VAX  Monitor  AP  announcing  the  host  shutdown,  then  shuts 
down  COMM,  its  MPU  and  finally  itself. 

5.  On  receiving  the  "Host  Shutdown"  message,  the  VAX  Monitor 
AP,  shuts  down  the  COMM  AP  for  the  link  to  the  shutdown 
ho6t,  updates  its  status  table  to  indicate  the  status  of 
the  shutdown  host,  sends  a  status  message  to  the  operator, 
and  a  "Host  Status  Update"  message  to  all  of  the  other 
active  IISS  hosts  Monitor  APS. 


*To  shutdown  the  VAX,  a  Shutdown  IISS  command  must  be  issued. 
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CANCEL  IISS  SHUTDOWN : 

1.  The  Monitor  accepts  the  oommand  and  sends  a  "Cancel 

Shutdown”  aessage  to  the  UIs,  and  then  updates  its  status 
froa  IISS  Shutting  Down  to  IISS  Active.  This  coaaand  only 
applies  during  the  tiae  that  shutdown  is  pending.  Once 
actual  shutdown  procedures  begins,  it  cannot  be  cancelled. 


ABORT  AP  (VAX  only): 

1.  The  operator  enters  AP  naae  to  be  shutdown  (the  operator 
finds  active  AP  naaes  froa  the  DISPLAY  ACTIVE  AP  coaaand). 

2.  If  the  AP  Naae  is  legal,  the  MONITOR  AP  sends  the  ABORT  AP 
aessage  to  the  correct  APC. 

3.  On  receipt  of  the  AP  abort  status  aessage,  the  MONITOR  AP 
displays  the  status  to  the  operator. 


DISPLAY  ACTIVE  APs  (VAX  only): 

1.  On  receipt  of  this  coaaand,  the  Monitor  AP  sends  a  aessage 
to  the  active  APC  entered  by  the  operator  requesting  a 
list  of  the  active  APs  on  that  APC. 

2.  On  receiving  the  active  list  aessage  froa  the  APC,  the 
list  is  displayed  for  the  operator. 


DISPLAY  IISS  STATUS  (VAX  only): 

1.  On  receipt  of  this  command,  the  Monitor  AP  displays  its 
host  and  APC  Status  tables  to  the  operator. 


4. 1.3. 2. 3  Deliver  IISS  Status  Messages  to  the  IISS  Operator 

This  function  is  responsible  for  displaying  IISS  status 
and  error  messages  to  the  IISS  operator  on  the  VAX.  These  are 
messages  signalling  events  that  might  require  some  operator 
action.  If  the  Monitor  AP  cannot  write  to  the  IISS  operator's 
console  from  which  it  was  started,  it  will  attempt  to  write  a 
message  to  the  System  Console. 
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4. 1 .5.2.4  Accept  Messages  froa  IISS  APC's  and  Off -Host  Monitor 
APs 


This  function  is  responsible  for  accepting  aessages  froa 
[ISS  APC's  and  off-host  Monitor  APs.  The  aessages  that  can  be 
eceived  during  the  various  IISS  states  are  listed  in  Figure 
,-15. 
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4. 1.3. 2. 5  Send  IISS  System  Commands  and  Responses 

This  function  Is  responsible  for  creating  and  sending  the 
IISS  systen  command  messages  from  the  VAX  Monitor  AP  to  the  IISS 
APC's,  APs,  and  off-host  Monitor  APs.  These  messages  are 
created  to  effect  an  IISS  Operator's  command  and  are  listed  in 
Figure  4-14.  See  Appendix  E  for  the  specific  format  of  these 
messages . 
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IISS  System  Message 


Command/Response 

Type 

Destination 

When  Sent 

Operator  Abort 

OA 

APC  of 

Requested  AP 

IISS 

Running 

Start  Link 

SL 

COMM  AP 

IISS 

Startup 

IISS  Running 

Cancel  Shutdown 

CS 

UI  APs 

IISS  Running 
with  IISS 
Shutdown 
Pending 

Start  MPU 

SC 

Monitor ' s 

MPU  on 
requested 

MPU's  Host 

IISS  Startup 
Host  Shutdown 
IISS  Running 

List  Request 

LR 

All  APC' s 

IISS  Running 
or  IISS  Shut¬ 
down  Pending 

Shutdown  Link 

SD 

COMM  APs 

IISS  Shutdown 
Host  Shutdown 
IISS  Running 

Shutdown  Pending 

SP 

UI  APs 

IISS  Running 
with  IISS 
Shutdown 
Pending 

Shutdown  APC 

DC 

Active  APC 

IISS  Running 
IISS  Shutdown 

Shutdown  Host 

SH 

Remote  -  Non-VAX 
Monitor  AP 

IISS  Running 
IISS  Shutdown 

Rebuild  Tables 

RB 

CDMRP  &  Monitor 
MPU  on  VAX 

IISS  Startup 

Figure  4-14 

.  IISS  System  Commands  and  Responses 
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IISS  System  Message 

Command/Response  Type  Destination  When  Sent 


COMM  9  Monitor  IISS  Startup 
MPU  on  Non-VAX  Hosts 

Display  System  DS  Monitor  AP  IISS  Running 

Status 


Figure  4-14.  IISS  System  Commands  and  Responses 
(Continued) 


< 
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4. 1.3. 2. 6  Process  Messages  from  APC's  and  Off -Host  Monitor  APs 

This  function  processes  the  Messages  received  by  the 
MONITOR  AP.  The  message  types  received  and  the  processing 
performed  are  in  Figure  4-15. 
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Ktitafi 

Httiafe  Type 

Source 

Vhen  Seat 

Processing 

Link  Active 

LA 

COMM  AP 

XXSS  Startup 

Update  Table 

Xnfora  Operator 

Link  rail 

LF 

COMM  AP 

XXSS  Startup 
X1SS  Running 
XXSS  Shutdown 

Opdate  Tables 
Xnfora  Operator 

rroctiiiaf 

Error 

31 

1ZSS  ARC'S 

XXSS  Startup 
XXSS  Running 

Xnfora  Operator 

A  PC 

Toralaatod 

CT 

XZSS  ARC'S 

X1SS  Startup 
XX8S  Running 
XXSS  Shutdown 

Opdate  Tables 

Logon 

LO 

01 -AP 

XXSS 

Running 

Opdate  Logon 

Table 

Logoff 

or 

01 -AP 

XXSS  Running 
or  XXSS 
Shutdown 

Opdate  Iiogon 

Table 

Table  Status 

Kaquast 

TS 

All  local 
ARC'S 

XXSS  Startup 
or  Running 

Send  Table  Status 
Return  (ST) 

Shutdown 

■ost 

SH 

VAX 

Monitor  AP 

XXSS  Running 
or  XXSS 
Shutdown 

Shutdown  Host 

APC  Alive 

LV 

XZSS  ARC'S 

XXSS  Startup 
or  XZSS 
Running 

Opdate  Tables 
Xnfora  Operator 

Resource 

Unavailable 

33 

ARC'S 

XXSS  Startup 
and  XXSS 
Running 

Xnfora  Operator 

AP  Interface 
Error 

83 

ARC'S 

XXSS  Running 

Xnfora  Operator 

Tables 

Rebuilt 

RD 

MRU's  of 
Monitor. 
CSHRP  or 
non -VAX 
CORK'S 

XXSS  Startup 

Send  ‘Most  Alive* 
Message  to  APC 

Tlaeout 

Expired 

TE 

Monitor's 

HPO 

Any  XXSS 

State 

Take  Tiaeout 

Act i on 

Unstable 

Table 

UT 

Any  MPO 

Any  XXSS 

State 

Xnfora  Operator 

Figure  4-15.  Processing  of  Messages  Received  by  a  Monitor  AP 
(Host  Status  Messages  in  4. 1.3. 8) 
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4. 1.8. 2. 7  Send  IISS  Status  Messages 

This  funetion  is  responsible  for  sending  a  Monitor  AP's 
IISS  status  Messages  to  reaote  Monitor  APs  and  looal  APC's.  The 
messages  to  the  reaote  Monitor  APs  ensure  that  each  IISS  Monitor 
AP  has  up-to-date  IISS  status  tables.  The  Status  Messages  to 
looal  A PCs  infora  the  A PCs  of  IISS  operating  conditions  and 
ensures  that  the  APC  will  know  when  to  perforn  cleanup 
functions.  The  status  Messages  sent  by  a  Monitor  AP  for  this 
purpose  are  described  in  Figure  4-16. 
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Message 

Message 

Type 

Update  APC  Tables 

UA 

Update  Host  Tables 

OH 

Host  Available 

HA 

Host  Active 

HU 

Off-Host  Shutting 

HS 

Destination 

When  Sent 

Renote  Monitor 

IISS  Startup 

APs 

IISS  Running 

Renote  Monitor 

IISS  Startup 

APs 

IISS  Running 

Renote  Monitor 

IISS  Startup 

APs 

IISS  Running 

Local  APC 's 

IISS  Startup 
IISS  Running 

Local  APC's 

IISS  Running 
Host  Shutdown 

Figure  4-16.  IISS  Monitor  Status  Messages 
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4.1.S.2.8  Receive  and  Process  Status  Message  from  Other  Hosts 
Monitor  APs 

This  function  is  responsible  for  receiving  and  processing 
status  aessages  froa  other  Monitor  APs.  The  processing  for  the 
two  identified  aessages  of  this  category  is  described  below. 


Message 

Message  Type 

Processing 

Host  Available 

HA 

Update  Tables 

Update  APC  Tables 

UA 

Update  Tables 

Update  Host  Tables 

UH 

Update  Tables 

Host  Terainating 

HT 

Update  Tables 
Infora  Local 
APCs 
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4.2  Petal lad  Functional  Requirements 

The  node  tree  shown  in  Figure  4-17  illustrates  all  HTM 
functions  defined  in  the  IDEF\0  Model  (soe  Appendix  B  below). 
Each  function  nane  is  followed  by  the  subparagraph  number  where 
a  description  of  the  function  nay  be  found. 


MANAGE 

MESSAGE 

MANACE 

PROCESS 

MAINTAIN 

OPERABILITY 

Receive  and 
Interpret  Message 
(4.2.1) 


Authorise 

Message 

(*.2.2) 


Complete 
Message  Header 

(4.2.3) 


Perform  Special 
Message  Handling 
(4.2.4) 


Log  Message 
(4.2.5) 


Interpret 
Message  Category 

(4.2.7) 


Initiate 

Application 

Process 

(4.2.8) 

Deliver 
Messages  to 
AP 

(4.2.9) 

Accept  Requests 
from  AP 

(4.2.10) 


Handle  System 

Commands 

(4.2.12) 


Handle  APC 
Message  Queues 
(4.  2.13) 


Handle  APC 

Tables 

(4.2.14) 


Terminate  AP 

(4.2.11) 


Route  and 
Send  Message 

(4.2.8) 


Figure  4-17.  NTM  Functions 
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4.2.1  Receive  and  Interpret  Message  Function 

The  Receive  and  Interpret  Message  function  is  responsible 
for  receiving  and  interpreting  all  messages  from  off-cluster 
that  are  targeted  for  this  cluster  and  all  messages  from 
on-cluster  that  must  be  routed. 

4.2. 1 . 1  Inputs 

Inputs  to  this  function  are  as  follows: 

Description  Source  Range 

Message  on-cluster  APs  All  categories 

on-cluster  MPU 
off-cluster  MPUs 

Message  Category  Table  Internal  tables 


4. 2. 1.2  Processing 

The  processing  of  the  Receive  and  Interpret  Message 
function*  is  described  below: 

a.  Messages  shall  be  received  in  the  APC's  input  MPU 
mailboxes  from  on-cluster  APs.  from  the  on-cluster 
MPU,  and  from  other  off-cluster  MPUs.  If  an  error 
is  detected  in  receiving  messages  from  the 
mailboxes.  Receive  and  Interpret  Message  shall 
generate  a  status  message  to  be  sent  to  the  Monitor 
AP. 

b.  A  message  that  has  been  successfully  received  at  an 
MPU  from  another  MPU  must  have  its  destination 
field  interpreted  to  determine  whether  the  message 
has  arrived  at  the  correct  cluster.  The  destination 
field  of  the  message  shall  be  checked  for  the  APC’s 
name  or,  if  being  routed  through  the  Communication 
Handler  APC,  for  a  legitimate  off -host  APC 
designation.  Valid  messages  from  other  APCs  shall 
bypass  the  Authorise  and  Complete  Message  Header 
Functions  and  be  sent  directly  to  Log  Message.  An 
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invalid  Message  from  off -o luster  shall  cause  a 
status  nessage  to  be  sent  to  the  Monitor  AP. 

c.  Messages  fron  on-oluster  APs  shall  indicate  whether 
header  be  perforaed  by  the  Manage  Message  Function. 
Header  checking  can  be  bypassed  if  a  header  that 
has  already  'passed'  Manage  Message  is  reused  by 
the  AP  Interface.  These  Messages  are  sent  directly 
to  Conplete  Message  Header  to  obtain  a  new  serial 
nuaber . 

d.  A  Message,  successfully  received  froa  on-oluster 
and  requiring  header  oheoking.  shall  have  its 
category  field  oheoked  against  a  table  of  legal 
categories.  Valid  Messages  shall  then  be  forwarded 
based  on  the  processing  requireaents  of  the  Message 
category.  Messages  that  require  authorisation  shall 
be  sent  to  Authorise  Message  and  Messages  that  do 
not  require  authorisation  shall  be  sent  to  Conplete 
Message  Header. 

e.  Invalid  Messages  shall  be  given  an  error  code  and 
shall  be  sent  to  Log  Message. 

f.  A  Message  froa  an  on-cluster  AP  with  an  invalid 
category  shall  cause  the  generation  of  a  no-accept 
status  return.  The  no-aooept  return  shall  be  sent 
to  Route  and  Send  for  delivery  to  the  source  AP. 

g.  All  Messages  froa  on-cluster  (froa  an  AP  or  fron 
the  MPU)  with  an  invalid  oategory  shall  cause  a 
status  Message  to  be  sent  to  the  Monitor  AP.  Since 
the  category  field  is  supplied  by  the  NTM  software, 
a  category  error  iaplies  an  NTH  software  failure. 

4.2. 1 .3  Outputs 

Outputs  froa  this  function  are  as  follows: 

Description  Destination  Range* 


Received  Messages  Authorise  Message  Category 

*A11  of  the  functions  and  their  interfaces  described  in  these 
sections  are  graphically  portrayed  in  the  IDEF\0  Model  contained 
in  Appendix  B  below. 
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Description 


Received  Messages 
(Continued) 


Send  Status  on 
Message  and  Status 
Messages  to  the 
Monitor  AP 


Destination 


function 


Conplete  Message 
Header  function 


Range 


A.B.E.H  and  J 
Messages 

All  Category  C , 
D,  F,  and  G 
messages  from 
on-cluster  to 
be  routed. 


Log  Message  function 


All  accepted 
messages  from 
off -cluster 


-and 


All  rejected 
messages 

Route  9  Send  Message  All  status 

function  messages  for 

the  Monitor  AP 
generated  by 
Receive  and 
Interpret 
function 

-and- 

Send  status 
returns  to 
on-cluster  APs. 


4.2.2  Authorize  Message  Function 

The  Authorize  Message  function  is  responsible  for 
establishing  the  authority  of  an  application  process  to  issue 
the  specified  message  type  to  the  specified  destination  AP. 

4.2.2. 1  Inputs 

Inputs  to  this  function  are  as  follows. 
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Description 


Source 


Range 


Messages  Possibly  Receive  0  Interpret 

Requiring  Authorisation  Message  Function 


Authority  Check  Internal  Table 

Table 

Authority  Table  Internal  Table 

4. 2. 2. 2  Processing 

The  processing  is  described  below: 


Category  A.B.E, 
and  H  Msgs  (Mgs 
Requiring 
Possible 
Authorisation) 

M/A 


M/A 


a.  A  message  arriving  at  Authorise  Message  is  first 
checked  for  an  authorisation  requirement.  The 
message  destination  is  checked  against  the 
Authority  Check  Table  to  determine  if  the 
destination  AP  has  any  authorisation  requirements. 
If  authorisation  is  not  indicated,  the  message  is 
sent  to  Complete  Message  Header. 

b.  A  message  that  requires  authorisation  shall  have 
its  message  type,  source  AP  and  destination  AP 
combination  checked  against  the  Authority  Table 
that  contains  a  list  of  message  types  that  are 
valid  between  the  specified  source  and  destination 
APs.  A  valid  message  is  sent  to  Complete  Message 
Header . 

c.  Invalid  messages  shall  be  given  a  status  indicating 
an  authorization  error  and  be  sent  to  Log  Message. 

d.  Authorize  shall  also  generate  a  status  return  to  be 
returned  to  the  originator  of  the  invalid  message. 
This  return  shall  be  sent  to  Route  and  Send. 


e.  Table  access  errors  shall  cause  a  status  message  to 

be  sent  to  the  Monitor  AP. 


f.  If  the  destination  AP  is  not  found  in  the  tables, 

an  invalid  destination  message  will  be  sent  to  the 
source  of  the  message. 
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4.2.2. 3  Outputs 

Outputs  from  this  function  are  as  follows: 


Description 

Destination 

Range 

Authorized  Messages 

Complete  Message 

Header  function 

Authorized 
Category  A. 

B,  E,  H,  and  J 
messages 

Messages  That  Did 

Not  Require 
Authorization 

Complete  Message 

Header  function 

Category  A,  B. 
E.  H,  and  J 
messages  with 
no  authori¬ 
zation  require¬ 
ment 

Send  Status  on 

Message  and  Status 
Messages  to  the 

Monitor  AP 

Route  9  Send  Message 
function 

"Authorization 
Denied"  status 
return 

Table  error  to 
Monitor  AP. 
Inval id 
Destination 
error  to  source 
AP 

Messages  rejected 
by  MM 

Log  Message  Function 

Rejected 

messages 

4.2.3  Complete  Message  Header  Function 

The  Complete  Message  Header  function  is  responsible  for 
supplying  message  header  information. 


4.2.3. 1  Inputs 

Inputs  from  this  function  are  as  follows: 
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Description 

Source 

Range 

Authorised  Category 

A.  B,  E,  H.  and  J 
Messages 

Authorise  Message 
Funotion 

Authorised 

Messages 

Category  A,  B,  E,  H,  J 
Messages  with  Mo 
Authorisation 
Requirement 

Authorise  Message 

Category  A,  B, 
E,  H.  and  J 
messages  with 
no  authority 
requirement 

Category  A-J 

Messages 

Receive  and  Interpret 
Message 

Category  A,  B, 
E,  H,  J  mes¬ 
sages  that  do 
not  require 
Header 

verification 

Category  C,  D, 
F,  G  messages 

Message  Category 

Table 

Internal  Table 

N/A 

AP  Information 

Table 

Internal  Table 

N/A 

AP  Characteristics 
Table 

Internal  Table 

N/A 

Message-Serial -Number 

Internal  Data  Item 

1-9,999.999 

4. 2. 3. 2  Processing 

a.  For  mes sages  that  require  header  verification 

(header  processing  flag  -  '0'),  Complete  Message 
Header  checks  the  required  header  fields  supplied 
by  the  AP  Interface  from  APC  tables  and  data  from 
the  AP’s  Service  Call.  If  any  required  field  is 
blank,  the  message  is  Invalid.  (Send  status  will 
indicate  'Header  Processing  Error').  Since  this 
error  may  indicate  an  NTM  failure,  a  status  message 
will  also  be  sent  to  the  Monitor  AP  indicating  an 
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* MPO  Processing  Error.' 

b.  For  messages  requiring  header  verification,  the 
Souroe  MPO  next  supplies  all  of  the  regaining  MPO 
header  values  exoept  a  Message  serial  number  to  the 
aessage  header.  (See  Section  4.1.S.1  for  a 
description  of  the  header  values.)  If  the  MPO 
cannot  find  any  required  field  entry  for  the  AP  in 
its  tables,  the  Message  is  invalid.  (Send  status 
indicates  'Table  Entry  Mot  Found  Error'). 

c.  The  MPO,  on  Messages  requiring  header  verification, 
aay  supply  default  values  for  the  following  header 
fields:  Binary/Native  Flag,  Integrity  Check  Flag, 
Test  Flag,  Delay  Trigger  Flag.  Delay  Trigger 
Conditions,  and  Logical  Channel  ID. 

d.  A  Message  serial  nuMber  is  supplied  to  the  header 
of  all  Messages  processed  by  Coaplete  Message 
Header.  This  serial  nunber,  with  the  APC  name  of 
this  cluster,  fores  a  unique  IISS  Message 
identifier . 

e.  Invalid  messages  shall  be  given  a  status  indicating 
the  type  of  error  and  are  sent  to  Log  Message. 

Valid  messages  shall  be  given  a  status  code 
indicating  their  validity  and  are  sent  to  Log 
Message. 

f.  MPO  file  and  table  access  errors  during  Complete 
Message  Header  shall  c^use  a  status  message  to  be 
sent  to  the  Monitor  AP. 

g.  Complete  Message  Header  shall  also  generate  a 
status  return  to  be  returned  to  the  originator  of 
the  invalid  message. 

h.  Complete  Message  Header  shall  check  the  message 
category  of  all  valid  messages  to  determine  if  any 
special  message  processing  is  required.  If  neither, 
an  "accepted"  status  message  shall  be  generated  to 
be  returned  to  the  originator. 

i.  All  messages,  except  status  returns,  status 
messages  to  the  monitor  AP,  and  messages  requiring 
special  message  handling  shall  be  sent  to  Log 
Message . 
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j.  Status  returns  and  status  messages  to  the  Monitor 
AP  shall  be  sent  to  Route  and  Send. 

k.  Messages  requiring  special  message  handling 
(Category  A.  B.  H,  and  J  messages)  are  sent  to 
Special  Message  Handling. 

4. 2. 3. 3  Outputs 

Outputs  from  this  function  are  as  follows: 

Description  Destination  Range 


Accepted  msgs  fro* 
on-cluster  with 
no  special  handling 
requirements 


Log  Message  Function 


Accepted 
Category 
C-G  messages 


Messages  from  on- 
cluster  with  a  special 
requirement 


Perform  Special  Message  Category  A, 
Handling  function  B,  H,  handling 

and  J  messages 


Messages  rejected 
by  MM 


Log  Message  Function 


Messages 
rejected 
by  Complete 
Message  Header 


Send  Status  on 
Message 


Status  Message  to 
Monitor  AP 


Route  and  Send  Message  "Header  Error" 
Function  Status  Return 


"Message 
Accepted" 
Status  Return 


Route  and  Send  Message  "Table  Access 
Function  Error"  msg  to 

MONITOR  AP 


"MPU  Processing 
Error"  message 
to  the  Monitor 
AP 
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4.2.4  Perform  Special  Message  Handling  Function 

The  Perform  Special  Message  Handling  function  is 
responsible  for  updating  the  MPU's  tables  for  guaranteed 
delivery,  message  pairing,  or  the  sending  APs  Child  Table  for 
messages  that  require  entries  in  any  of  these  special  message 
tables. 

4.2.4. 1  Inputs 

Inputs  to  this  funotion  are  as  follows: 


Description 

Source 

Range 

Category  A  Messages 
from  on-cluster 

Complete  Message  Header 

Guaranteed 

Delivery 

messages 

Category  B  and  D 
Messages  from 
on-cluster 

Complete  Message  Header 

Message 
requiring  a 
response 

Category  H  and  J 
Messages  from 
on-cluster 

Complete  Message  Header 

Specific 

Initiation 

messages 

Category  E  Messages 
having  no  Destination 
Instance 

Complete  Message  Header 

Message  that 
may  require  the 
initiation 
of  an  AP 

Message  Pairing  Table 

Internal  table 

M/A 

Guaranteed  Delivery 
Table 

Internal  table 

N/A 

Child  Table 

Internal  Table 

N/A 

4. 2. 4. 2  Processing 


a.  If  the  message  received  is  a  Category  A  message,  an 

entry  is  made  to  the  Guaranteed  Delivery  Table. 


b. 


If  the  message  received  is  a  Category  B.  D  or  J 
message,  an  entry,  with  a  timeout  value,  is  made  to 
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the  Message  Pairing  Table.  If  the  table  entry  is 
successfully  Bade ,  a  'message  accepted'  status  is 
returned  to  the  sender. 

c -  If  the  message  received  is  a  Category  H  or  J  message, 

an  entry  that  indicates  a  status  of  'initiation 
message  sent'  is  made  to  the  Child  Status  Table  for 
the  sending  AP.  If  the  table  entry  is  successfully 
made ,  a  'message  accepted'  status  is  returned  to  the 
sender . 

d.  If  there  is  no  destination  instance  and  the  category 
indicates  that  an  AP  may  be  initiated  (i.e.  category 
B  or  E)  a  child  table  entry  will  be  created  with  a 
status  of  ‘‘reserved” . 

e.  If  the  attempt  to  make  an  entry  into  any  of  the 
tables  is  unsuccessful,  a  'Resource  Unavailable'  send 
status  is  returned  to  the  sender  via  the  Route  and 
Send  message  function.  In  addition,  a  'Table  Access 
Error'  status  message  is  sent  to  the  Monitor  AP  to 
inform  the  IISS  operator  of  the  event. 

f.  Messages  that  were  not  processed  because  of  table 
access  failures  are  sent  to  Log  Message  with  a 
logging  code  that  indicates  'Resource  Unavailable'. 

4. 2. 4. 3  Outputs 


Outputs  from  this 

function  are  as  follows: 

Description 

Destination 

Range 

Processed  Category  A, 

B.  D,  and  H  messages 
from  on-cluster 

Log  Message  function 

All  Category  A. 
B,  D,  H,  and  J 
messages  that 
have  been 
successful ly 
processed  in 
Special  Message 
Handl ing . 

Unaccepted  Category  A,  Log  Message  function 
B.  D,  and  H  messages 
from  off -cluster 


All  messages  B, 

(Category 

A,  B,  D.  H  and  J) 
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Description 


Destination 


Range 


Unaccepted  Category 
A,  B,  D  and  H  Messages 
from  off -cluster 
(Continued) 


Send  Status 


Route  9  Send  Message 
funotion 


Status  Message  to 
Monitor  AP 


Route  B  Send  Message 
function 


that  oould  not  be 
processed 
by  Special 
Message  Handling 
due  to  a 
Table  Access 
Error . 

"Accepted 

Message" 

status  returns  on 
successfully 
processed 
Category  B,  D,  H. 
and  J  Messages . 

"Resource 
Unavailable" 
status  returns  on 
all  Category  A, 

B,  H,  and  J 
■essages  that 
were  not 

processed  because 
of  a  Table  Access 
error . 

"Table  Access 
Error"  status 
Message  to  the 
Monitor  AP  on 
Messages  not 
successful ly 
processed  by  the 
Special  Message 
Handl ing 
function . 


4.2.5  Log  Message  Function 

The  Log  Message  function  is  responsible  for  logging  Messages. 
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4.2.5. 1  Inputs 

Inputs  to  this  function  are  as  follows: 


Description 

Source 

Range 

Message  Rejected 
by  MM 

Receive  9  Interpret 
Message  function 

Rejected  messages 
from  off -cluster 
due  to  routing 
failures 

Rejected  messages 
from  on-cluster 
due  to  unrecog¬ 
nized  category 

Authorize  Message 
function 

Rejected  messages 
from  on-cluster 
due  to  an 
authorization 
failure 

Complete  Message 
Header  function 

Rejected  messages 
from  on-cluster 
due  to  header 
errors 

Message  Rejected 
by  MM  (Continued) 

Perform  Special 

Message  Handling 

Rejected  messages 
from  on-cluster 
due  to  special 
message  handling 
fai lure 

Accepted  Messages 
from  On-cluster 

Complete  Message 

Header  function 

Accepted  messages 
with  completed 
header  (all 
categories) 

Accepted  Messages 
from  Off-Cluster 

Receive  9  Interpret 
Message  function 

Accepted  messages 
off-cluster  (all 
categories) 

Log  Fornat 

Internal  Tables 

N/A 
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4. 2. 5. 2  Processing 

The  processing  is  described  below. 

a.  Log  Message  shall  add  an  entry  to  the 

aessage  log  for  each  aessage  received.  The 
log  entry  will  include:  the  aessage,  an 
error  oode  for  rejected  aessages ,  and  the 
host's  clock-tine  staap  at  the  tiae  of  the 
log. 

b.  Entries  into  a  separate  error  log  could  be 

aade  for  all  error  conditions  encountered 
in  the  aessage  processing.  The  foraat  of 
this  error  log  has  not  yet  been  deterained 
but  should  include  an  error  code,  the 
error  souroe,  ID  and  the  host's  clock-tiae 
staap.  For  the  initial  Test  Bed,  this  will 
not  be  a  separate  log. 

c.  Log  Message  shall  check  the  aessage 

category  to  deteraine  if  guaranteed 
delivery  is  required.  If  so,  a  "logged" 
status  aessage  shall  be  generated  to  be 
returned  to  the  originator. 

d.  If  an  error  occurs  in  logging.  Log  Message 

shall  generate  a  status  aessage  to  be  sent 
to  the  Monitor  AP  via  Route  and  Send 
Message.  Error  conditions  nay  include  file 
access  errors,  file  space  errors  and  file 
write  errors. 

e.  All  accepted  aessages  shall  be  sent  to 

Route  and  Send  Message. 


4. 2. 5. 3  Outputs 

Outputs  fron  this  function  are  as  follows: 
Description  Destination 


Logged  Messages  Route  8  Send  Message 

function 


Range 


All  accepted  and 
logged  aessages 
fron  off-cluster 
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Description 


Send  Status 


Status  Messages  to 
Monitor  AP 


Message  Log 


Destination 


^oute  9  Send  Message 
function 


Route  9  Send 
Message  function 


Internal  file 


Range 


All  accepted  and 
logged  Messages 
fron  on-cluster 

Message  accept 
status 

on  Guaranteed 
Del ivery 
■essages 

Status  Message 
to  the  Monitor  AP 
"Error  condition 
on  log" 

M/A 


4.2.6  Route  and  Send  Message  Function 


The  Route  and  Send  Message  function  is  responsible  for 
forwarding  Messages  to  their  next  destination. 

4.2.6. 1  Inputs 

Inputs  to  this  function  are  as  follows: 

Description  Source  Range 


Logged  Messages 


Send  Status  and 
Status  Messages 


Log  Message  function  All  accepted 

and  1 ogged 
Messages 
fro*  on-cluster 
and  off -cluster 


Receive  8  Interpret  All  status  re- 

Message  function  turns  to  the 

Source  AP  and 
status  Messages 
to  the 
Monitor  AP 

Authorize  Message 
function 
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Descr 1 pt i on  Source  Range 


Complete  Message  Header 
function 

Perfora  Special  Message 
Handling  function 

Log  Message  function 

Host  8  A PC  Status  Internal  Tables  M/A 

Tables 


4. 2. 6. 2  Processing 

The  processing  is  described  below. 

a.  Route  and  Send  Message  shall  check  the  destination 
field  of  a  aessage  and  aooess  internal  table 
lnforaation  to  determine  routing. 

b.  If  the  destination  is  for  an  on-oluster 
application,  the  aessage  shall  be  sent  to  the 
Manage  Process  function  of  the  NTM. 

c.  If  the  aessage  is  a  system  command  (Category  C  and 
D  Messages )  for  the  on-cluster  NTM,  the  aessage 
shall  be  sent  to  the  Maintain  Cluster  Operability 
function  (Handle  System  Commands,  4.2.12). 

d.  If  the  destination  is  off-cluster.  Route  and  Send 
Message  shall  check  the  host  designation. 

e.  If  the  destination  is  off-cluster,  the  status  of 
the  destination  APC  will  be  checked  in  the  APC 
Status  Table.  If  the  destination  APC  is 
unavailable,  a  status  aessage  is  sent  to  the 
monitor  AP  and  the  source  to  inform  them  that  the 
destination  resources  are  unavai lable.  If  the 
aessage  is  a  guaranteed  delivery,  it  will  be 
queued.  Otherwise,  the  aessage  is  lost. 

f.  If  the  destination  cluster  is  on-host,  the  message 
shall  be  sent  to  the  correct  off-cluster  mailbox 
(Reoeive  and  Interpret  Message  function  of  MM). 
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g.  If  the  destination  is  off-host,  the  message  shall 
be  sent  to  the  correot  on-host  COMM  A PC  mailbox 
(Receive  and  Interpret  Message  function). 

h.  If  a  recoverable  error  (e.g.,  mailbox  full)  is 
detected  on  a  send.  Route  and  Send  Message  shall 
queue  the  message  for  later  delivery. 

i.  If  an  unrecoverable  error  (e.g.,  unrecoverable 
status  returned).  Route  and  Send  Message  shall 
generate  a  status  message  and  attempt  to  6end  it  to 
the  Monitor  AP. 

j .  If  an  unrecoverable  error  oocurs  on  sending  a 
message  to  the  Monitor's  A PC,  ERRPRO  will  be 
called. 

4. 2. 6. 3  Outputs 


Outputs  from  the  function  are  as  follows: 


Description 

Destination 

Range 

Messages  to  Off- 
cluster 

Manage  Message:  via 
Off-Cluster  MPU  mail 
box  Receive  B  Inter¬ 
pret  function) 

All  messages 
with 

off-cluster 

destinations 

On-cluster  AP 

Messages ,  Send  Status 

Manage  Process  (Inter¬ 
pret  Message  Category 
function) 

All  messages 
with  on- 
cluster  AP 
destinations 

Manage  Process 

All  status 
returns  for 
on-cluster 
messages 

Status  Returns 

Accept  Requests  from 

AP  of  the  Manage  Pro- 

All  on-cluster 
status  returns 

cess  function 
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Description 


Destination 


Range 


Status  Messages 
Monitor 


Manage  Message  function 
of  the  Monitor  AP's 
MPO 


All  status  to 
Messages 
to  aonitor 
AP 


4.2.7  Interpret  Message  Category  Function 

The  Interpret  Message  Category  function  is  responsible  for 
receiving  a  Message  froM  the  Route  and  Send  Message  function  and 
forwarding  it  to  the  appropriate  Manage  Process  subfunction. 

4.2.7. 1  Inputs 

Inputs  to  this  function  are  as  follows: 

Description  Souroe  Range 


On-cluster  AP  Message,  Route  9  Send  Message 
Send  Status  function  of  Manage 

Message 


Message  Category  Table  Internal  tables 


Shutdown  AP 
request 
Abnorual ly 
terminate 
AP  request 
Data  Messages 
for  APs  Status 
response 

M/A 


4. 2. 7. 2  Processing 

The  processing  is  described  below. 

a.  This  function  shall  accept  as  input  an  on-cluster 
AP  Message  or  Message  for  the  NTH  from  Manage 
Message. 


b. 


This  function  shall  interpret  the  Message  category 
based  on  the  Message  category  table  and  route  the 
Message  to  the  appropriate  function  as  follows: 
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•  A  aessage  that  explicitly  requires 
initiation  of  an  application  process 
(Category  H  or  J)  shall  be  routed  to 
Initiate  Application. 

•  A  shutdown  AP  request  or  abnormally 
terminate  AP  request  Message  shall  be  routed 
to  Terminate  Application  Process. 

•  A  Data  Message  shall  be  routed  to  deliver 
Message  to  Application  Process. 

4. 2. 7. 3  Outputs 

Outputs  from  this  function  are  as  follows: 

Description  Destination 


Interpreted  Message  Initiate  Application 

Process  function 

Abnormal ly  Terminate 
or  Shutdown 
AP  function 


Deliver  message  to 
AP  function 


4.2.8  Initiate  Application  Process  Function 

The  Initiate  Application  Process  function  is  responsible 
for  initiating  and  establishing  a  connection  with  an  application 
process . 


Range 


Category  A,  B.  E, 
H  and  J  messages 

Shutdown  AP 
request 
Abnormal ly 
Terminate 
AP  request 

Data  Message 


4.2.8 . 1  Inputs 

Inputs  to  this  function  are  as  follows: 
Description  Source  Range 


Category  A,  B,  E, 


Interpret  Message 


Message 
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Description 

Souroe 

Range 

H,  and  J 

Messages 

function 

identified 
as  an  initia¬ 
tion  message 

AP  Initiation  Service 
Request 

Initiated  AP 

M/A 

Startup  Status 

Messages  from  the 
Initiated  AP's 

Interface 

AP  Interface 

"I'm  Alive" 

status 

message 

‘Startup 

failed" 

status  message 

Initiate  0  Connect 

AP  Status  Response 

Most  Operating  System 
or  IPC  Primitive 

Status  return 
indica¬ 
ting  status  of 
AP  initiate  and 
connect 

AP  Operating  Infor¬ 
mation  Table 

Internal  Tables 

N/A 

AP  Characteristics 
Table 

Internal  Tables 

M/A 

AP  Status  Table 

Internal  Tables 

N/A 

I'm  A1 ive  Table 

Internal  Tables 

N/A 

4. 2. 8. 2  Processing 

a.  On  an  initiation  request  message,  the  AP  Operating 

Information  Table  of  the  APC  is  referenced  to 
determine  the  number  of  instances  of  the  AP  that 
are  currently  active  and  to  determine  the  number  of 
requests  that  are  queued  for  the  AP. 


a.  1 


If  there  are  no  instances  of  the  AP  currently 
active,  the  MPU  shall  initiate  the  AP. 
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a. 2  If  there  are  one  or  sore  instances  of  the  AP 
currently  active,  the  KPU  shall  check  the  AP 
Characteristic  Record  to  determine  if  the 
requested  AP  is  a  queue  server  and  deteraine 
the  maxi&um  nuaber  of  running  instances  of 
this  AP  allowed. 

a. 2.1  If  the  AP  is  a  queue  server 

(nuaber  of  parents  per  instance  is 
greater  than  one),  the  MPU  shall 
check  the  AP  Characteristic  Table 
to  deteraine  the  aaxiaua  nuaber  of 
connections  allowed  for  this  AP 
against  the  nuaber  of  current 
connections  indicated  in  the  AP 
Status  Table. 

a. 2. 1.1  If  the  nuaber  of  current 
connections  is  less  than 
the  aaxiaua  nuaber 
allowed,  the  aessage  is 
sent  to  the  AP's  aailbox 
and  the  nuaber  of  AP 
connections  is  updated  in 
the  AP  Status  table. 

a. 2. 1.2  If  the  number  of  current 
connections  is  equal  to 
the  aaximum  allowed,  the 
AP  Characteristic  Record 
is  checked  and  the 
conditions  are  handled  as 
in  a . 2 . 2  and  a . 2 . 3 . 

a. 2. 2  If  the  number  of  active  instances  is  less  than  the 
number  allowed,  the  MPU  shall  initiate  the  AP. 

a. 2. 3  If  the  number  of  active  instances  is  equal  to  the 
maximum  number  allowed,  the  AP's  characteristic 
record  is  checked  to  determine  the  allowed  number 
of  queued  requests  for  the  AP. 

a. 2. 3.1  If  the  maximum  queue  size 
is  greater  than  the 
current  queue  size,  the 
message  is  queued  for  the 
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AP  and  the  AP  Operating 
Information  Table  is 
updated  to  indicate  an 
addition  to  the  queue  for 
the  AP. 

a. 2. 5. 2  If  the  maximum  queue  sine 
equals  the  current  size, 
a  "Resource  Unavailable" 
status  message  is 
formatted  and  sent  to 
Manage  Message  for 
routing  to  the  MPU  where 
the  initiation  request 
was  made. 

b.  If  initiation  of  an  AP  is  indicated. 

Initiate  AP  requests  the  host  Operating 
System  to  initiate  the  AP.  The  MPU 
supplies  a  process  name  for  the  AP  in 
the  initiation  request. 

b.l  If  a  successful  initiation  is  indicated  by 

the  Operating  System  Response,  the  following 
procedure  is  followed. 

b.1.1  The  AP  Status  Table  is  updated  with  a 
new  record  for  this  new  instance  of 
the  AP.  The  6 tat us  is  indicated  as 
initiated . 

b.l. 2  An  entry  into  the  I'm  Alive  Table  is 
made  to  indicate  that  the  MPU  is 
awaiting  a  message  from  the  initiated 
AP  to  indicate  that  it  successfully 
started  execution. 

b.l.S  If  the  data  portion  of  the  initiation 
message  is  non-blank  (data-length  - 
0).  the  data  for  the  AP  shall  be 
queued  to  be  delivered  when  the  AP's 
"I’m  Alive"  message  is  received. 

b.l. 4  The  AP  Operating  Information  Table  is 
updated  to  Indicate  the  current 
number  of  instances  active. 


4-65 


DS  620142000 
1  November  1985 


b.2  If  a  non-successful  initiation  is  indicated 
in  the  Operating  System  Response,  the  MPU 
will  send  an  “Initiation  Failure"  message  to 
the  MPU  where  the  initiation  request 
originated.  A  status  message  will  al6o  be 
sent  to  the  Monitor  AP  to  indicate  the 
initiation  failure  event. 

b.3  On  receipt  of  an  “I'm  Alive"  message  from 
the  initiated  AP,  the  MPO  changes  the  AP's 
process  status  state  entry  from  “initiated" 
to  "running",  signals  the  Deliver  Message 
function  to  send  the  IISS  System  State 
Status,  and  any  AP  data  that  was  carried  in 
the  initiation  message  to  the  initiated  AP. 

b. 4  If  instead  of  an  "I'm  alive"  message,  the 

MPU  reoeives  an  "Initiation  failure"  message 
from  the  AP  Interface,  it  updates  the  APC 
tables  to  indicate  the  failure  event  and 
sends  the  “Initiation  failure"  messages 
described  above  in  b.2. 

when  an  IISS  AP  is  initiated,  it  must  call  one  of 
the  NTM's  Initiation  Service  Routines.  New  APs  will 
call  "INITAL"  [8],  the  NTM  Service  module  described 
below. 

c. l  "INITAL”  provides  the  mailbox  connections  of 

the  AP  to  the  NTM  that  will  enable  the  AP  to 
send  and  receive  messages  from  other  IISS 
APs . 

c.1.1  "INITAL"  creates  the  AP's  low 
priority  and  ACK  mailboxes. 

c.l. 2  "INITAL"  uses  the  IPC  Primitives  [9], 
that  in  turn  use  operating  system 
calls  to  create  the  required  AP  input 
mailboxes.  The  AP's  MPU-given  process 
naime  is  used  to  form  the  AP's  mailbox 
names;  the  process  naime  is 
concatenated  with  A  for  an  AP's  ACK 
mailbox,  and  with  C  for  the  AP's 
normal-  priority  mailbox.  "INITAL" 
determines  the  AP's  process  name  by 
an  operating  system  call  on  the  VAX 
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and  from  the  Initiation  parameter 
list  on  the  Honeywell  and  the  IBM. 

If  the  nailbox  connection  requests  are 
successful,  "IHITAL”  establishes  an  IISS 
exception  handler  for  the  AP.  (This 
Exception  Handler  will  trap  all  Operating 
Systeas  and  Maohine  Exceptions  for  the  AP, 
formulate  a  status  message  for  the  MPU  of 
the  AP's  parent  (spatmer),  and  then 
terminate  the  AP . ) 

If  the  initiation  procedure.  IHITAL,  is 
still  suooessful  at  this  point,  an  “I'm 
Alive”  message  that  oontains  the  AP's 
process  name  is  sent  to  one  of  its  HPU's 
mai 1 boxes . 

o.S.l  If  a  non- recoverable  failure  status 
is  returned  on  this  I PC  SEHD  to  the 
HPO's  mailbox,  ” IHITAL”  oalls 
ERRPHO,  and  returns  an 
IHXTAL-HOT-SUOCES8FUL  oode  to  the 
oalling  AP. 

c.3.2  If  a  "mailbox-full”  status  is 

returned  on  this  I PC  SEHD.  a  timer  is 
set  by  * IHITAL”  and  on  the  timers 
completion,  the  SEHD  is  repeated. 

This  step  is  repeated  until  the  call 
is  successful  or  until  the  number  of 
times  tried  surpasses  the  IISS  set 
limit. 

If  the  "I'm  Alive”  message  is  successfully 
sent,  ‘IHITAL”  reads  (with  a  wait)  the  AP’s 
input  mailbox  for  a  message  from  the  MPU 
that  contains  the  IISS  System  State  (IISS 
Startup.  IISS  Recovery,  or  IISS  Mornal 
Operations)  for  special  AP  startup  state 
information,  such  as,  first  run  since  IISS 
start.  The  system  state  message  also  carries 
information  about  the  AP,  such  as  the  number 
of  mailboxes  it  supports,  and  the  original 
source  AP.  A  timer  is  also  set  when  the 
read  is  issued. 
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o.4.1  If  a  mailbox  event  oocurs  before  the 
timer  and  the  received  message 
contains  the  IISS  system-state 
information.  "INITAL"  checks  the 
number  of  mailboxes  the  AP  will 
support  (None,  if  the  AP  receives  no 
messages;  one.  if  the  AP  can  receive 
no  high-priority  shutdown  messages 
from  the  MTM ,  and  two.  if  the  AP  can 
reoeive  high-priority  messages.)  If 
the  AP  supports  no  mailboxes,  the  low 
priority  and  ACK  are  deleted.  If  the 
AP  supports  two  mailboxes.  " INITAL" 
will  create  the  AP's  high  priority 
mailbox.  Upon  successful  handling  of 
the  mailboxes  returns  to  the  AP  with 
the  8 YSTEM - 8TATE  and  a  successful 
STARTUP - STATUS . 

o.4.2  If  the  message  received  is  not  the 
system-state  message.  " INITAL" 
returns  to  the  AP  with  an 
IMITAL-MOT-SDCCESSFUL  status. 

c.4.3  If  a  timer  event  occurs  before  a 

mailbox  event,  " INITAL"  returns  to 
the  AP  with  an  INITIAL-MOT-SUCCESSFUL 
status . 

L.  Figure  4-18  depicts  the  roles  of  the  AP.  the  AP 

Interface  and  the  MPU  in  the  successful  initiation 
of  an  AP. 
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AP 


AP  Interface 


MPU 


3.  Executing  AP  calls 
"INITAL"  to  ini¬ 
tiate  its  connection 
to  the  NTM 


1 .  OS  cal 1  to 
initiate  AP 

2 .  Successful 
return  from 
OS  call  -  A 
C  table  up¬ 
dates  to 
indicate  the 
initiation 
of  AP 


4.  "INITAL"  creates  the 
AP's  Low  Priority  and 
ACK  mailboxes 

5.  "INITAL"  establishes 
the  IISS  exception 
handler  for  the  AP 

6.  "INITAL"  sends  an 
"I'm  Alive"  message 
to  the  MPU 

7.  The  MPU  re¬ 
ceives  the 
"I'm  Alive" 
message  and 
updates  its 
AP  state  ta¬ 
bles  accor¬ 
dingly. 

8.  The  MPU 
sends  the 
AP  the  IISS 
System 
State 

information 
and  any 
AP  initiation 
data  that  was 
carried  in 
the  initia¬ 
tion  message 


Figure  4-18.  AP  Initiation 
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10.  The  AP  begins  its 
operating  code 
and  issues  &  CALL 
-RCV"  if  it  expects 
initiation  data 


9.  IHITAL  receives  the 
system  state  nessage 
fro*  the  MPU  establishes 
the  correct  number  of 
mailboxes  and  return 
to  the  AP 


Figure  4-18.  AP  Initiation  (Continued) 
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4. 2. 8. 3  Outputs 

Description  Destination  Range 


Initiate  AP  Request 

Create  AP  Mailbox 
Request 

Initiation  Status 
Messages  froa  AP 
Interface 


Initiation  Status  Msg 
Arrival  Motifioation 


Host  Operating  Systea  M/A 

Host  Operating  Systea  M/A 

(via  IPC  Priaitive) 


Manage  Message  Funotion  "I ‘a  Alive" 
(MPU's  input  aailbox)  "Initiation 

Failed" 

asgs 


Deliver  Message  "I 'a  Alive” 

to  AP 


Initiation  Status 
Messages  to  the 
MONITOR  AP  and  souroe 
MPU  froa  the  AP's  MPU 


Manage  Message  Funotion 


"Initiation 

Failure" 

messages 


AP  Message  Queue  Update  Internal  Table 


Initiation  Data 
for  AP 


A PC  "I 'a  Alive"  Table  Internal  Table 
Entry 


” I ' a  Alive 
Waiting  Entry 

"I 'a  Alive" 
Arrived  - 
Cancels  Entry 


4.2.9  Deliver  Messages  to  Application  Process 


The  Deliver  aessage  to  Application  Process  function  is 
responsible  for  delivering  aessages  to  the  AP.  This  function 
includes  the  MPU's  writing  of  the  aessage  to  the  AP's  aailbox. 
and  the  AP  Interface 's  reading  of  the  aessage  froa  the  AP's 
aailbox.  its  stripping  of  the  MTM  aessage  header,  and  its 
delivery  of  the  aessage  data  to  the  destination  AP. 


4.2.9. 1  Inputs 

Inputs  to  the  function  are  as  follows. 
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Decor ipt ion 


Source 


Range 


Messages  for 
On -Cluster  APs 


Interpret  Message 
Category 


All  Messages 
for  on-o luster 
APs 


Operating  Systea  Host  Operating 

Response  ( I PC  Response)  Systea 


Responses  to 
"SMDMSG" . 
"RCVMSG” . 
"8ETTIM" , 
"WAIT",  I PC 
Priaitives 


MTM  Service: 
Call  "RCV" 
Arguaents 


Souroe  AP  Requesting  R/A 
Message 


4. 2. 9. 2  Processing 

a.  On  reoeipt  of  a  aessage  for  an  on-cluster  AP  that 
has  already  been  initiated  by  the  aessage  souroe. 
the  Deliver  Message  to  AP  function  sends  the 
aessage  to  the  correct  aailbox  of  the  AP. 

a.l  If  an  unrecoverable  error  status  is 

returned  on  the  'SMDMSG'  call,  a  status 
aessage  is  sent  to  the  aonitor  AP  and  to 
the  MPU  of  the  aessage  source  signifying 
the  ' MAILBOX  WRITE  ERROR . ' 

a. 2  If  the  AP's  aailbox  is  full,  the  aessage  is 
added  to  the  on-cluster  AP's  aessage  queue. 

b.  On  notification  by  the  Initiate  Message  function  an 
of  an  "I 'a  Alive"  aessage  froa  an  initiated 
on-cluster  AP,  Deliver  Message  foraulates  and  sends 
to  the  AP,  a  Systea-State  Message  that  contains 
IISS  State  Inforaation,  and,  if  required,  a  aessage 
containing  the  AP's  initiation  data.  On  a  send 
failure,  the  actions  of  a.l  or  a. 2  are  taken. 

c.  In  response  to  an  AP's  RCV  Service  Request,  the  AP 
Interface  first  searches  the  AP's  aessage  buffer 
for  the  requested  aessages .  If  it  is  found  then 
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Step  o.l  Is  performed.  If  it  is  not  found  the  AP 
Interfaoe  reads  the  AP's  mailbox(es) .  If  a  wait  is 
Implied,  the  AP  Interfaoe  waits  for  a  message  and 
when  one  is  reoeived,  eheoks  whether  the  message 
header  satisfies  the  AP's  request.  If  no  wait  is 
signaled,  a  “GETM8G”  I PC  oall  is  made  after  the 
"RCVMSG”  oall. 

o.l  If  a  message  is  in  the  buffer  or  in  the 

mailbox  and  is  of  the  type  requested,  the  AP 
Interfaoe  removes  the  MTM  header  and  delivers 
the  data  portion  and  required  arguments  to 
the  AP. 

o.2.  If  the  message  is  not  of  the  type  requested, 
the  AP  Interfaoe  buffers  the  message  for  a 
later  AP  request  and  either  returns  to  the  AP 
with  a  non-message  status  if  the  request 
signalled  “no-wait. "  or  rereads  the  AP's 
mailbox(es)  for  another  message  if  the  AP's 
request  implied  a  “wait." 

If  an  unrecoverable  error  is  detected  on  the 
“RCVMSG”  or“GETM8G”  I PC  calls,  the  AP  Interfaoe 
generates  and  sends  a  status  message  to  the  Monitor 
AP.  and  returns  a  failure  status  to  the  AP. 

Figure  4-19  depicts  the  roles  of  the  AP.  the  AP 
Interfaoe  and  the  MPU  on  a  ”RCV“  (with  wait) 
request  from  an  AP.  Mote  that  events  la  and  lb 
ooour  asynchronous ly. 
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AP 


AP  Interface 


MPO 


la.  The  AP  issues  an 
NTM  service 
request . 

CALL  "RCV-  with  a 
the  wait  indicated 


4.  The  AP  receives  back 
oontrol ,  its  data, 
and  the  "RCV*  call 
arguments 


lb.  As  the  MPU 
aessages  for 
the  AP.  it 
delivers  the 
message  to  the 
AP's  mailboxes 
If  the  AP's 
mailbox(es)is 
full,  the  MPU 
queues  the 
message  for 
later  delivery 

2.  The  AP  interfaces 
responds  to  the  AP's 
"RCV"  request,  by 

•  First  searching  the 
AP's  buffer  for  a 
message  of  the  type 
requested 

e  If  the  request 

message  is  not  found, 
the  AP  Interface  reads 
the  AP ' s  mai lbox 
indicated  by  the  "RCV" 
request  until  the  mail¬ 
box  is  either  empty  or 
a  message  of  the  type 
requested  is  found. 

(The  sequenoe  of  I PC 
calls  is  RCVMSG ,  WAIT; 
then  on  a  mailbox  event. 

GETMSG . ) 

3.  On  finding  a  message  of 
the  type  requested,  the 
AP  Interface  strips  the 
NTM  header  from  the 
message  and  returns  the  AP's 
data  and  required  "RCV" 
return  arguments  to  the  AP. 


Figure  4-19.  A  "RCV"  (with  wait)  AP  Scenario 


1 
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4. 2. 9. 2  Outputs 

Description  Destination  Range 


OS  Prooess  Control 
Requests  (via  I PC 
Primitives) 


Host  Operating  System  I PC  Primitives: 

"SMDMSG" 

“RCVMSG" 

"GETMSG" 

"WAIT" 

“SETTIM“ 


Service  Calls  Return  AP 
to  the  Requesting  APs 
(Messages  to  the  on- 
cluster  AP) 


NTM  service 
calls: 

Call  -RCV" 
Call  "CHKMSG” 
returns 


A PC  Message  Queue 
Updates 


Status  Message 
to  Monitor  AP  and 
and  Source  MPUs 


Internal  Tables 


Manage  Message 


Messages  for  APs 
whose  mailboxes 
were  full  on 
a  "SlfDMSG” 
request  - 
delivery  to  be 
retried  at  queue 
check  time 

Error  messages : 
Unrecoverable 
errors  on  IPC 
Pimitives 


4.2.10  Accept  Requests  from  Application  Process 

The  Accept  Requests  from  Application  Process  function  is 
responsible  for  accepting  and  servicing  AP  Service  Requests. 
The  Service  Requests  that  an  AP  may  use  are  described  in  the 
IISS  Programmers  Guide  [8]. 

4.2.10.1  Inputs 

Inputs  to  this  function  are  as  follows. 
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Description 


Source 


Range 


NTH  Service  Request 
Arguments  [8] 

OS  Process  Control 
Response 


Send  Status  Responses 


APC  Tables 


AP 

Kost  Operating  System 
(possibly  via  an  IPC 
Primitive) 

Manage  Message 


Internal  Tables 


[8] 


Reponses  on 
IPC  Primitives 


"Message 
Accept  *  or 
"Message 
Reject" 

responses  from 
MM 

AP  Status 

Table 

AP 

Characteristic 

Table 


4.2.10.2  Processing 

On  an  AP's  NTM  Service  request  ([8]  and  Figure  4-20)  the 
called  AP  Interface  routine  begins  execution,  accepts  the 
arguments  of  the  Service  call  and  begins  the  servicing  of  the 
requests.  The  connection  and  communication  requests  with  the 
resulting  AP  Interfaces  actions  are  described  in  Figure  4-19. 

For  all  of  the  Services,  an  unrecoverable  error  results  in  a 
"failure"  status  return  to  the  AP  and  a  message  to  the  MONITOR 
AP  that  indicates  the  error  condition.  ERRPRO  is  called  if  the 
status  message  cannot  be  delivered  to  the  MPU's  mailbox(es). 

The  NTM  Request  Services  can  obtain  status  information  from 
APC  tables  (WHATAC,  PRSTAT ,  GDSTAT ) ,  cause  request  messages  to 
be  sent  for  IISS  status  (APSTAT,  HSTATS ,  WHTHST ,  ACSTAT,  GETUSR) 
and  cause  messages  to  be  sent  to  effect  the  AP's  request 
(SIGABT.  WKONCA). 

Services  which  are  implemented  in  Release  2.0  are  indicated 
by  an  asterisk  in  Figure  4-20  (*). 
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MTM  AP  Interface 

Services  AP  Interfaces  Processing  - 


INITAL* 


TRMNAT* 


ENDRCY 


NSEND* 


e  Maps  to  the  A PC  tables 

e  Deternines  the  AP's  MTM  given  process 
nane 

e  Creates  the  AP's  required  input  mailboxes 
using  the  AP's  prooess  nause  as  the 
mailbox  name 

e  Establishes  the  AP's  message  buffer  area 

e  Establishes  the  IISS  Exception  Handler 
for  the  AP 

•  Sends  an  "I'm  Alive"  message  to  the  local 
MPU 

e  Waits  for  the  "System-State"  Message  from 
the  MPU 

e  On  receiving  the  Sy6ten-State  message,  it 
completes  mailbox  processing  and  returns 
control,  the  System  State,  and  the 
Startup  Status  to  the  AP 

e  Sends  an  "I'm  Dying"  message  to  the  local 
MPU 

•  Disconnect  the  AP'6  input  mailboxes 

•  Ends  the  execution  of  the  AP 

•  Sends  a  "Recovery  Complete"  message  to 
the  Monitor  AP 

e  Returns  control  to  the  AP 

•  Accepts  the  data  and  calling  arguments 
from  the  AP 

•  Formulates  NTH  message(s)  that  includes 
the  correct  NTM  header  and  the  AP's  data. 
The  data  may  be  packet i zed  into  several 
NTM  messages  if  it  is  longer  than  the 
maximum  NTM  message  data  length.  The 
packet! zing  of  continuation  messages  is 
transparent  to  the  AP. 

•  Sends  the  message,  using  the  IPC 
primitive,  "SNDMSG",  to  the  correct  MPU 
mailbox.  If  the  MPU's  mailbox  is  full,  it 
resends  the  message  until  the  send  is 
successful . 


Figure  4-20.  NTM  Service  Call  AP  Interface  Processing 
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•  If  MTM  header  processing  is  required,  it 
waits  for  the  return  status  on  Message 
acceptance  froe  Manage  Message, 
e  On  receipt  of  the  Message  send  status  or 
if  no  header  processing  is  required . 
returns  oontrol  to  the  AP  with  the 
oorreot  status  returns. 

GDSEMD*  e  Sane  as  MSEMD,  except  that 

e  GDSEMD  oauses  the  resulting  Message  to  be 
one  of  Category  A 

e  On  acceptance,  returns  control  and  the 
Message  serial  nuaber  to  the  AP  so  that  a 
future  status  Inquiry  on  the  GD  Message 
nay  be  Made 

ISEMD*  e  Sane  as  MSEMD.  exoept  that 

e  I8EMD  causes  the  resulting  Message  to  be 
a  Category  1  or  J  Message 

QSEMD*  e  Sane  as  M8EMD.  exoept  that 

e  Q8EMD  is  only  used  by  Queue-Server  APs 
e  QSEMD  sends  the  ’reply*  Message  to 
exactly  the  last  instance  of  the 
Destination  froa  which  we  had  received 
froa  last.  If  we  have  not  received  froa 
our  destination  AP.  we  cannot  send  this 
reply  Message. 

Figure  4-20.  MTM  Service  Call  AP  Interface  Processing 
(Continued) 
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NTH  A?  Interface 
Services 

CHKM8G* 

SETDLT 

GDACK* 

HSGACK 

RCV* 

Figure  4-20. 


AP  Interfaces  Processing 


e  Checks  the  AP's  buffer  for  a  message  of 
the  requested  type 

e  If  not  found,  reads  the  AP's  input 
mailbox(es)  until  empty  or  until  the 
correct  message  type  is  found 

e  Returns  the  appropriate  status  to  the  AP 
either  "message  found"  or  "message  not 
found" 

•  Checks  the  validity  of  the  call's  message 
delay  arguments 

•  If  valid,  saves  the  arguments  for  the 
header  for  the  next  "NSEND" .  "GDSEND" .  or 
" ISEND"  call's  message  and  returns  to  the 
AP 

•  If  not  valid,  returns  to  the  AP  with  a 
no-accept  status 

•  Accepts  the  input  arguments  from  the  AP 

•  Formulates  an  NTH  message  of  type  GDACK 
for  the  MPU  of  the  originating  GD  message 

•  Delivers  the  message  to  the  local  MPU's 
mai lbox 

•  Returns  control  to  the  AP 

•  Same  as  GDACK,  except  that  the  message 
destination  is  the  AP  that  sent  the 
message  requiring  the  ACK. 

•  Accepts  the  input  arguments  of  the  RCV 
call 

•  Checks  buffer  and  AP  s  mailbox  for  the 
message  requested.  (See  [8]  for  the  AF  ; 
request  options.) 

NTH  Service  Call  AP  Interface  Process  inf 
(Continued) 
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MTM  AP  Interface 
Servioes 


RCV  (Continued) 


TSTMOD* 
(Partial ly 
inplenented) 


SIGERR* 


APSTAT 


Figure  4-20. 
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AP  Interface  Processing 


e  If  found,  the  AP  Interface  strips  the  NTM 
header  from  the  AP's  message  and  returns 
that  data  and  return  arguments  to  the  AP. 

e  If  the  requested  message  is  not  found  and 
a  wait  was  requested  by  the  AP  the  AP 
Interface  waits  until  a  mailbox  event  is 
signaled.  It  then  performs  the  previous 
step. 

e  If  the  requested  message  is  not  found  and 
no  wait  was  signaled,  the  API  returns 
control  to  the  AP  with  a  "No  Message" 
status 

•  Checks  the  TSTMOD  argument 

e  If  it  signals  'ON' ,  all  asynchronous 

error  messages  sent  after  will  be  passed 
to  the  AP. 

e  If  it  signals  'OFF',  all  messages  sent 
after  will  be  discarded 

e  The  default  TSTMOD  setting  is  “Off"  or 
"0" 

•  Formats  the  Signal  Error  (SE)  message 
using  the  given  AP  Name  and  AP  Error 
Code,  severity  level,  and  error 
description. 

•  Sends  the  SE  message  to  the  original 
source  AP  (typically  the  DI)  and  to  the 
monitor  AP. 

•  Formats  the  AP  Status  Request  (SR) 
message  using  the  given  AP  Name. 

•  Forwards  the  SR  message  to  the  NTM  for 
processing  (if  AP  is  local  -  Read  APS 
table,  if  AP  is  off-cluster  -  forward 
message  to  appropriate  MPU). 

•  Receives  the  AP  Status  Return  (IS)  from 
the  NTM 

•  Passes  the  AP  Status  data  to  the 
requesting  AP. 

NTM  Service  Call  AP  Interface  Processing 
(Continued) 
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mm  AP  Interface 
Servioes 


HSTATS 


WHATAC 


WKONCA 
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AP  Interface  Processing 


e  Formats  the  Host  Status  Request  (HR) 
message  using  the  given  Host  Marne . 

e  Forwards  the  message  to  the  local  MPO  for 
processing  (read  Host  Status  Table). 

e  Receives  the  Host  Status  Return  (HO) 
message  from  the  Local  MPO. 

e  Passes  the  Host  Status  Data  to  the 
requesting  AP. 

e  Formats  the  Host  Name  Request  (HR) 

message  using  either  the  given  AP  Name  or 
the  name  of  the  AP  to  which  the  service 
is  currently  bound. 

e  Forwards  the  message  to  the  NTH  for 
processing  (Read  API  and  APC  Tables). 

e  Reoeives  the  Host  Name  Return  (HH)  or 
processing  error  message  from  the  Local 
MPO. 

e  Passes  the  Host  Marne  to  the  requesting 
AP. 

e  Formats  the  APC  Marne  Request  (AN)  message 
using  either  the  given  AP  Name  or  the 
name  of  the  AP  to  which  the  service  is 
currently  bound. 

e  Forwards  the  message  to  the  Local  MPO  for 
processing  (read  AP  Information  Table). 

e  Receives  the  APC  Name  Return  (NA)  message 
from  the  local  MPO. 

e  Passes  the  APC  Name  to  the  requesting  AP. 

e  Formats  the  APC  Availability  Request  (AV) 
message  using  the  given  APC  Name. 

•  Forwards  the  message  to  the  local  MPO  for 
processing. 

•  Receives  the  APC  Available  Return  (VR) 
message  from  the  MPO. 

e  Passes  the  relevant  return  status  to  the 
requesting  AP. 


Figure  4-20. 


NTM  Service  Call  AP  Interface  Processing 
(Continued) 
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ITM  AP  Interface 
Services 


ACSTAT 


SIGABT 

(Partially 

inplenented) 


Figure  4-20. 


AP  Interface  Processing 


e  Fornats  the  APC  Status  Rquest  (PS)  using 
the  given  APC  Sane. 

e  Forwards  the  message  to  the  Local  MPU  for 
processing  (read  APC  Status  Table), 
e  Receives  the  APC  Status  Return  (PR) 
message  from  the  MPU. 
e  Passes  the  APC  status  data  to  the 
requesting  AP. 

e  Formats  the  Abort  AP  (AB)  message  using 
the  given  AP  Marne  and  logical  channel, 
e  Forwards  the  message  to  the  Local  MPU  for 
processing  (process  message  and  send  to 
given  AP). 

HTM  Service  Call  AP  Interface  Processing 
(Continued) 
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NTH  AP  Interface 

Servioes  AP  Interface  Processing 


e  Returns  the  sending  status  of  the  message 
to  the  requesting  AP.  Mote:  the  API  does 
not  return  the  status  of  the  Abort 
procedures  in  thi6  call. 

PRSTAT  e  Formats  the  Paired  Message  Status  Request 

(MS)  message  using  the  given  message 
destination  and  logical  ohannel . 
e  Forwards  the  message  to  the  Looal  MPU  for 
processing  (Read  Message  Pair  Table), 
e  Reoeives  the  Paired  Message  Status  Return 
(MR)  message  from  the  Looal  MPU. 
e  Passes  the  Paired  Message  Status  to  the 
requesting  AP. 

GDSTAT  e  Formats  the  QD  Status  Request  (GS) 

message  using  the  given  Message  Serial 
Number. 

e  Forwards  the  message  to  the  looal  MPU  for 
processing  (Read  GD  Table), 
e  Receives  the  GD  Status  Return  (GR)  from 
the  Local  MPU 

e  Passes  the  GD  message  status  to  the 
requesting  AP. 

GETUSR*  e  Locates  the  original  source  AP  Name. 

•  If  the  original  source  AP  is  a  user 
interface;  accesses  the  Logon  Table  to 
determine  the  user  logon  data. 

•  Returns  the  original  source  data  to  the 
requesting  AP. 

Figure  4-20.  NTH  Service  Call  AP  Interface  Processing 
(Continued) 

*  Indicates  services  implemented  by  Release  2.0. 
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4.2. 10. S  Op t puts 

Description  Destination  Range 


Messages  to  be 
Routed 

08  Requests 
(IPC  Primitives) 


Manage  Message 

Host  Operating 
Systen 


All  message 
types 

IPC  Primitive: 
"SNDMSG" 
"GETMSG" 
"RCVMSG" 

"WAIT" 

"SETTIM" 


AP  Initiation 
Requests 


Initiate  Application  NTM  Service 

Prooess  "INITIAL" 


AP  Termination 


Terminate  Application  NTM  Service 

"TRMNAT" 


4.2.11  Terminate  Application  Process  Function 

The  Terminate  Application  Prooess  function  is  responsible 
for  terminating  or  signaling  shutdown  to  an  application  prooess. 

4.2.11.1  Inputs 

Inputs  to  this  function  are  as  follows: 

Description  Source  Range 


AP  Termination  Aocept  Requests 

from  "TRMNAT "Request  AP 


Messages  for 
On -Cluster 


Terminate  AP 
Status  Response 


Interpret  Message 
Category 


"I'm  Dying" 
message 
from  AP 
"Shutdown  AP" 
message  "Abort 
AP"  message 


Host  Operating  System 


Status  msg 
indicating 
6tatus  of  Abort 
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Description  Souroe  Range 


AP  request 

AFC  Tables  Internal  Tables  AP  Status  Table 

AP  Child  Table 
AP  Characteris¬ 
tic  Table 

4.8.11.8  Processing 

The  processing  is  desoribed  below. 

4.2.11.2.1  Abnormally  Terminate  or  Shutdown  AP 

Upon  reoeipt  of  an  "abort  AP"  or  "shutdown  AP"  request  this 
function  shall  (Rote:  the  abnormal  abort  logio  is  not 
implemented  in  Release  2.0) 

a.  Check  the  AP  8tatus  Table  to  determine  if  the 

requested  AP  has  an  entry. 

a.l  If  it  has  an  entry  but  the  AP  has  already 

terminated,  the  MTM  send  an  "AP  Terminated" 
message  to  the  HTM  where  the  request 
originated. 

a.  2  If  there  is  no  entry  in  the  Status  Table,  an 

'Awaiting  IRIT'  entry  is  made  in  the  Process 
Status  Table.  This  is  made  because  the  abort 
message  (high  priority)  may  get  to  the  HTM 
before  the  initiation  message  (low  priority). 
When  the  expected  initiation  message  is  later 
reoeived,  the  entry  is  removed  from  the  table 
and  an  "abort  aok"  is  sent  to  the  MTM  where 
the  abort  request  was  made. 

b.  If  the  AP  has  a  status  entry  and  is  running, 
then  the  MTM  checks  the  AP  Characteristic 
Reoord  to  determine  whether  the  AP  expects  an 
"abort"  message  that  signals  "soft-abort”  to 
APs  that  perform  special  processing  on  aborts, 
or  runs  to  completion,  or  expects  an  MTM  abort 
on  this  event. 


b.l  If  a  "soft-abort”  message  is  expected. 
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the  MPO  foraats  a  Message  of  this  type, 
and  delivers  the  Message  to  the  AP ' s 
high  priority  aailbox. 

If  an  MTM  abort  is  required,  the  MPO 
uses  a  host  operating  systea  service  to 
terainate  the  AP. 

On  teraination,  the  AP's  process  status 
is  updated  to  “aborted”.  A  "ohild 
status”  Message  is  sent  to  the  parent 
AP.  If  the  abort  request  was  froa  the 
operator,  an  "ACM*  is  also  sent  to  the 
MONITOR  AP  for  the  Operator's  Console. 
The  ohild  table  of  the  AP  is  checked  for 
alive  APs  that  were  spawned  by  the 
aborted  AP.  For  each  alive  ohild  AP,  an 
"Abort  AP”  Message  is  sent  to  the  MPU  of 
the  ohild  AP.  The  abort  protocol  is 
described  as  scenarios  in  Figure  4-21. 

On  the  receipt  of  a  ‘child  status  AP 
aborted"  Message,  the  receiving  MTM; 

b.4.1  Checks  the  status  of  the  parent 
AP  fluid,  if  running,  ohecks  the 
parent's  AP  Characteristic  Record 
to  deteraine  whether  to 
e  send  an  “aborted  child"  status 
Message  to  the  AP,  or 
e  abort  the  parent  AP,  or 
e  let  the  parent  AP  continue  and 
not  send  it  a  status  Message. 
b.4.2  In  addition,  the  MTM  of  the 

parent  AP  updates  the  child  table 
of  the  parent  AP  to  indicate  the 
new  status  of  the  aborted  AP. 

b.4.3  On  receipt  of  a  child  status 
Message  that  indicates  the 
conpletion  of  one  branch  of  the 
APs  child  tree,  the  MTM  checks  to 
see  if  all  children  of  a 
terainated  AP  are  also 
terainated.  The  MTM  of  the  AP 
sends  a  cleanup  Message  to  the 
MTM  of  each  AP  in  its  child  tree 
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and  then  removes  the  AP's  entry 
from  the  Process  Status  Table  and 
its  Child  Table  entries. 

b.5  On  the  reoeipt  of  a  "oleanup"  message, 
the  receiving  NTH.  removes  the 
designated  AP's  entries  in  the 
Application  Prooess  Status  Table  and 
associated  chi Id  table. 

b.6  Where  the  ZZSS  state  is  "IISS  shutdown," 
no  acknowledgement  or  child  abort 
processing  is  performed  on  the  Abort  AP 
or  Shutdown  AP  message  .  Zt  is  assumed 
that  each  A PC  will  do  its  own  AP 
shutdown  and  oleanup. 

b.7  Zf  the  ZZSS  state  is  “Host  Shutdown”  or 
“APC  Shutdown” .  on  the  Abort  AP  or 
Shutdown  AP  message,  acks  and  child 
abort  notifications  are  sent,  but 
shutdown  prooeeds  without  waiting  for 
any  child  status  or  oleanup  messages. 

b.8  No  messages  are  sent  to  APC's  or  hosts 
in  shutdown  state. 

b.9  Zf  the  AP  is  of  the  type  ”Run  to 

Completion,”  it  is  allowed  to  oomplete 
if  the  ZZSS  is  not  in  APC.  HOST,  or  IISS 
Shutdown  node. 
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4. 


API 

- AP2r-rr - ^ — 

(running) 

(■boOed)" 

-►  APS  (running) 

1.  AP2  is  aborted  by  its  MPO 

2.  API's  MPO  sends  a  child 
status  (abortack)  to  AP2's 
parent  with  the  status  of 
AP2 ' s  child  tree 
(children  running) 

S.  MTM  sends  ABORT 

aessages  to  APS's  and 
APS's  MPO 6 


API's  MTM  updates 

4'  . 

APS  and  API ' s 

ohild  table  to 

AP5  are  indicate 

"ohild  aborted 

aborted 

with  children 

5'  . 

Child  status 

active,"  on  receiving 

aessages  are 

the  child  status 

sent  to  aessage 

AP2 

AP2 ' s  MPO 

5.  API's  characteristic 
record  is  checked 
to  deteraine  what 
action  should  be 
taken  on  the  ohild 
status  aessage 
froa  AP2 

7.  If  API  is  to  be 
aborted :  the  NTM 
aborts  API  and  sees 
that  its  child  tree 
in  the  prooess  of 
terainating,  so 
waits  for  child 
status  aes sages  that 
indicate  coapletion 
of  the  tree 


6.  APB's  MTM  receives 
both  ohild  status 
asgs  froa  AP2  9 
AP5  that  indicates 
their  terainations, 
updates  its  tables, 
sends  cleanup  aes6ages 
to  AP2  9  APS's  HTMs, 
and  sends  a  "children" 
terainated”  aessage 
to  API’s  MPO  7’.  AP2  9  APS’s 

NTMS  reaove 
the  process 
6tatus  and  is 
child  table 
entries  for 
AP2  9  APS 


Figure  4-21 .  MTM  Abort  AP  Protocol 
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8.  On  receiving  the 

"children  terminated" 
aessage  fron  AP2 ' s 

MTM,  API's  MTM  9.  AP2's  MTM  receives 

removes  API's  table  the  oleanup  aessage 

entries  and  sends  froa  API's  MPU  and 

a  cleanup  aessage  reaoves  its  table 

to  AP2 ' s  MTM  entries  for  AP2 

Figure  4-21.  MTM  Abort  AP  Protocol  (Continued) 
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4.2.11.2.2  Normal  Termination 

Upon  receipt  of  an  “I'm  Dying-  message  from  an  AP,  the  NTM 
sends  a  child  status  message  to  the  NTM  of  the  parent  (or 
s pawner )  of  the  terminated  AP.  Child  table  processing  and 
cleanup  continues  as  indicated  in  Figure  4-22. 
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API  _ 

-».AP3 

Spawns 

terminates 

- — te  AP4 

1 .  AP2  terminates  - 
sends  “I'm  Dying" 
message  to  its  NTH 

2.  MTM  of  AP2  sends  child 
status  message  to  API 
indicating  AP2  normal 
termination  with 
children  active 

S.  MTM  of  API  receives 
child  status  message 
from  AP2's  MTM. 

Checks  to  see  if 
API  get6  informed 
of  event  and  handles 
this  appropriately. 

4.  MTM  of  API  updates 
API ' s  chi Id  status 
table 

5.  APS  and  AP4 
terminate, 
send  status 
messages  to 
the  NTM  of 
AP2 

6.  MTM  of  AP2  receives 
child  term i nat i on 
messages,  6ees  that 
child  tree  is  complete 
removes  its  entries 
for  AP2  and  sends 
status  asg  to  API's 
MTM. 

Figure  4-22.  MTM  -  Mormal  AP  Termination  Protocol 
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7.  MTM  of  API  receives 
the  status  aessage, 
and  on  teraination 
of  API  and 
ooapletion  of  all 
API's  ohildren. 

API ' s  MTM  sends  a 
cleanup  Message  to 
MTM 


8.  MTM  of  AP2  sends  a 

oleanup  Message  to  APS 
and  AP4 ' s  MTM' s 

9.  APS  and  AP4's 
MTM  reaove 
all  APS  and 
AP4  table  AP2's 
entries 

10.  MTM  of  AP2  receives 
9  processes  its 
cleanup  Message 


Figure  4-22.  MTM  -  Moraal  AP  Teraination  Protocol  (Continued) 
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4.2.11.3  Out putt 

Description  Destination 

OS  Requests  to  Abort  Host  Operating  Systen 

APs 

Messages  to  be  Routed  Manage  Message 


A PC  Table  Updates  Internal  Tables 


Operating  Systen 
dependent 
proeess  teraina- 
tlon  requests 

"I 'a  Dying" 
aessage  froa 
terainating  AP 

Child  status 
aes sages  to 
MTMe  of 
terainating 
AP's  parent 

Cleanup  aessages 
to  MTM  of  child 
APs. 

AP  Process  Table 
Child  Table 


4.2.12  Handle  Systea  Coanands 

The  Handle  Systea  Coaaand  function  is  responsible  for 
processing  ooaaands  froa  the  Monitor  AP  for  the  APC. 

4.2.12.1  Inputs 


Inputs  to  this  funotion  are  as  follows: 

Description  Source 

Messages  for  Maintain  Manage  Message 

(APC)  Operability 

(MO) 
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Range 

"Shutdown  APC" 
"Shutdown  AP" 
"Display  Active 
APs"  "Recover 
APC"  (TBD) 
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Description 
OS  Responses 


Host  Tables 


A PC  Queues  and 
Tables 


Source 


Host  Operating  System 


Range 

A PC  Startup 
Responses  to 
"Get  APC  name 
request” 
Response  to 
"Hap  to  Host 
Tables  Request” 


Internal  Tables 


Message 
Definition 
APC.  Host 
Status  Tables 


Internal  Tables  All  APC  Tables 


4.2.12.2  Processing 


The  Handle  System  Command  function  processes  the  IISS 
System  Commands  from  the  Monitor  AP  according  to  the  following 
procedures . 


System  Command 
START  APC 


HTM  Processing 

1.  Gets  the  MPU's  process  name. 

2.  The  MPU,  on  startup,  maps  to  the  host 
tables  that  are  maintained  by  the 
Monitor  AP. 

3.  Creates  the  MPU's  high  and  low 
priority  input  mailboxes  using  is 
process  name  concatenated  with  ”H"  and 
"C"  for  the  mailbox  names. 

4.  If  steps  1-3  are  successful,  the  MPU 
sends  a  "Table  Configuration  Status 
Request”  to  the  Monitor  AP.  If  steps 
1-3  have  failed,  it  sends  a  startup 
fail -status  message  to  the  Monitor  AP. 
If  it  cauinot  send  a  message  to  the 
Monitor  AP,  it  calls  ERRPRO  and 
terminates . 
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Shutdown  AP 
Shutdown  A PC 


5.  If  processing  is  still  successful,  the 
MPU  waits  for  a  "Table  Status"  message 
from  the  Monitor  AP. 

6.  The  remaining  startup  protoool  is 
described  in  Figure  4-25 

See  4.2.11.2.1 

1.  Sets  A PC  Shutdown  flag. 

2.  Does  abort /shutdown  processing  for 
each  AP  in  AP  Status  Table 
(4.2.11.2.1) 

5.  Processing  continues  until  the 

mailboxes  are  empty  and  all  AP's  are 
dead. 

4.  Saves  queues 

5.  Saves  initialisation  data. 

6.  Deletes  mailboxes. 

7.  Sends  "APC  Terminating"  message  to  the 
Monitor  AP. 

8.  Terminates 
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MPU  (after  being  initiated)  Monitor  AP 

1.  Sends  "Table  Status  Request" 
message  and  waits  for  return 
message. 

2a.  On  receipt  of  message,  and 
if  tables  are  OK  sends 
"Tables  OK"  message  to  MPU 

2b.  On  receipt  of  message  and 
tables  not  OK,  sends 
"Tables  Mot  OK"  message  to 
MPU 

3a.  On  receipt  of  "Tables  OK" 
message,  reads  local  files 
to  build  tables. 

•  If  table  read  is  successful, 

sends  "APC  Alive"  message  to  Monitor 

•  If  table  read  fails,  sends 
"Table  Access  Failure" 
message  to  monitor 

e  If  return  message  times  out, 
the  APC  will  terminate. 

3b.  On  receipt  of  "Tables  MOT" 
message,  requests  CDM  data 
and  sends  either  success 
or  failure  message  to  the 
Monitor  AP  on  completion 

4a.  On  "APC  Alive"  message, 
updates  APC  status  to 
running,  and  sends 
'Host  Active'  message  to 
the  APC 

4b.  On  "Table  Access  Failure" 
message,  monitor  updates 
APC  6tatus  to  "down"  and 
notifies  operator  of 
condition. 

5a.  On  receipt  of  the  'Host 
Active'  message  fromm  the 
Monitor  AP,  it  sets  its 
status  from  'startup'  to 
'running'.  Normal  proces¬ 
sing  can  now  begin. 

5b.  If  the  return  message  times 
out,  the  APC  will  terminate. 

Figure  4-23.  APC  Startup  Protocol 
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Svst  —  COMMd 
Display  Active  APs 


4.2.13.3  Outputs 
Description 

ItipoBM  Messages 

to  Monitor  AP 


A PC  Tables  9  Queue 
Updates 

Queue  Requests 

4.2.13  Handle  A PC  1 

The  Handle  A PC 
maintaining  the  APC 

4.2.13.1  Inputs 

Inputs  to  this 


MTM  Pr pops sing 

1.  Creates  a  message  with 
information  about  each 
aotive  AP  on  its  AP  Cluster 

2.  Delivers  the  message  to 
Monitor  MPUs  mailbox 


Destination 

Manage  Messages 


Internal  Table 


Range 

Messages : 
“Table  Status 
Request* 

“APC  termina¬ 
ting” 

“APC  Alive* 
“Aotive  APs “ 
“Error  Condi¬ 
tions* 

“Table 

Requests* 

All  APC  Tables 


Handle  APC  Message 
Queues 


“Initiate";  Re¬ 
cover  (TBD) , 
Save  Queues 


iessage  Queues 


Message  Queues  function  is  responsible  for 
message  queues. 


function  are  as  follows. 
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Description 
Queue  Requests 

08  Responses 

Host  Tables 

A PC  Tables 

Message  Category 
Table 


Source 


Range 


Handle  Systea  Coaaand 
Function 


Host  Operating  Systea 
(IPC  Priaitives) 


Initiate, 
Recover  (TBD) , 
Save  Queues 

Tiae  out  Event 
Responses  on 
"8MDMSG"  IPC 


Internal  Tables 


A PC  Status 
Table, 

Host  Status 
Table 


Internal  Tables 


All  A PC  Tables 
8  Queues 


Internal  Tables 


A-J 


4.2.13.2  Processing 

There  are  two  types  of  aessage  queues  within  the  IISS; 
off -cluster  and  on-cluster.  Each  queue  is  used  to  hold  aessages 
that  cannot  be  sent  due  to  a  destination  aai lbox  full  condition. 
Guaranteed  Delivery  aessages  are  the  only  aessages  queued  if  the 
destination  is  otherwise  unavailable. 

Both  types  of  queues  operate  on  a  first- in-first-out  basis 
(FIFO).  Their  entries  are  kept  in  index-sequential  order  with  the 
local  APC  naae  as  an  integral  part  of  the  pr inary  key.  Unique 
processing  for  each  queue  type  is  described  below. 

1.  Off-Cluster  Queue  (APCQUE.DAT):  When  the  MPU  has  a 

aessage  for  another  APC,  it  will  check  the  AP  Cluster 
Status  table  to  deteraine  the  status  of  the  destination 
APC.  If  the  destination  APC  is  not  available,  a  status 
aessage  is  sent  to  the  aessage  source  AP  and  to  the 
Monitor  AP.  If  the  aessage  is  Guaranteed  Delivery,  it 
will  be  queued  in  the  off-cluster  queue.  Otherwise,  the 
aessage  is  lost. 

If  the  destination  APC  is  active,  the  MPU  will  atteapt  to 
place  the  aessage  in  the  destination's  aai lbox.  If  the 
aai lbox  is  full  the  aessage  is  queued.  On  the  MPU's  tiner 
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prooessing.  the  queue  Is  oheoked  for  extent  Messages.  If 
any  are  found,  the  send  will  again  be  attempted  until  the 
queue  is  enpty  or  the  nailbox  is  full. 

2.  On-Cluster  Queue  (APQUE.DAT):  When  a  aess&ge  has  been 
aooepted  for  delivery  to  an  on-o luster  AP.  the  queue  is 
oheoked  for  extent  aes sages  to  the  destination  that  have 
yet  to  be  delivered.  Any  Messages  already  in  queue  will 
be  delivered  first  to  ensure  serial  prooessing.  Messages 
will  be  placed  in  the  AP's  Mailbox  until  all  Messages  are 
delivered  or  the  AP's  Mailbox  is  full.  On  a  Mailbox  full 
or  AP's  initiating  oondltlon  the  Messages  will  be  queued. 
The  on-oluster  queue  is  periodically  oheoked  as  part  of 
the  MPU's  tiaer  prooessing. 


4.2.13.5  Outputs 

Description 

Destination 

Updated  Queues 

Internal  Tables 

Message 

MM  V  HP 
Queues 

Messages  to  On- 
cluster  APs 

Deliver  Message 
to  AP 

All  Message 
categories 
for  APs 
tine-out 
Messages 

Messages  for  Off- 
cluster 

Mauiage  Message 

A1 1  Message 
categories 

Status 
Messages  to 
Monitor  AP 

OS  Process  Control 
Requests 

Host  Operating  Systen 

"SNDMSG"  I PC 
Prinitlves 

OS  file 
h&ndl ing 
coaaands 


4.2.14  Handle  Local  APC  Tables  Function 

The  Handle  Local  APC  Table  function  is  responsible  for 
Maintaining  the  APC  tables. 
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function  are  as  follows: 
Souroe 

Handle  System  Command 
Function 


4.2.14.1  Inputs 

Inputs  to  this 
Description 
Table  Requests 

OS  Responses 


Host  Operating  System 
(IPC  Primitives) 


Message  Category 
Table 

Host  Tables 

APC  Local  Tables 


Internal  Tables 

Internal  Tables 

Internal  Tables 


Range 

Initiate. 
Recover  (TBD) , 
Terminate 

Time-out  Event 

Responses  on 
"SNDMSG"  IPC 

Response  on 
"ABORT  AP 
Requests 


A-J 


APC  Status  Table 
Host  Status 
Table 

All  APC  Tables 


4.2.14.2  Processing 


APC  Tables  are  maintained  by  the  following  processing  (See 
Figure  4-24  for  an  overview  of  the  tables  involved.): 


Event  Processing 

APC  Startup  All  APC  Local  Tables  are  initialized 

and  built  from  local  files  or  from 
CDM  data  depending  on  Monitor's 
start  table  command  (4.2.12.2) 


Time-out 


The  following  APC  Dynamic  Tables  are 
processed  on  a  time-out  event: 
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Event 

t 

*  Tine-out  (Continued) 


APC  Shutdown 


Processing 

1.  Message  Pairing  Tables  -  the 
pair  table  on  the  APC  is  checked 
for  ness ages  whose  timeouts  have 
expired.  On  expired  messages,  the 
AP  characteristic  record  of  the 
waiting  AP  is  cheoked  to  deteraine 
whether  the  AP  should  receive  a 
tine-out  message  or  be  aborted. 

The  appropriate  action  is  taken  by 
the  MPU. 

2.  Guaranteed  Delivery  Table  -  the 
guaranteed  delivery  table  entries 
are  ohecked  to  see  if  an  ACK  from 
the  next  receiving  MPU  has  been 
received.  If  the  table  indicates 
no  response  to  the  GD  message,  a 
status  request  is  sent  to  the  MPU 
from  which  a  response  is  due. 

If  the  table  indicates  an  expired 
time  with  no  response  to  a  GD 
status  request  from  an  MPU  that 
has  been  sent  a  status  request,  a 
status  message  is  sent  to  the 
Monitor  AP. 

3.  "I'm  Alive”  table  -  these  table 
entries  are  checked  for  entries 
with  elapsed  time-outs.  Those 
entries  will  cause  an  ”Init 
failure”  message  to  be  sent  to  the 
Monitor  AP  and  the  MPU  from  which 
the  AP  initiation  request  was 
sent . 

1 .  GD  Tables  are  saved 

2.  APC  Files  are  closed 
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4.2. 14. S  Outputs 
Description 
Status  Messages 

Messages  to  On- 
cluster  AP 

A PC  Tables 


Destination 

Manage  Message 
aessages 

Deliver  Message  to 
AP 

Internal  Tables 
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Range 

Status 

to  MOHITOR  AP 
and  to  MPUs 

Tlae-out 

aessages 

All  A PC  Tables 
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i' 

•v 


■:* 


4.8  Special  Requirements 

4.8.1  Programming  Methods 

NTH  programming  methods  shall  conform  to  the  standards  set 
forth  by  General  Electric  In  the  IISS  Software  Development 
Guidelines/Conventions  document  [10]. 

4.3.2  Program  Organisation 

This  paragraph  is  not  applicable  to  the  NTM  CPCI . 

4.8.8  Modification  Consideration 

This  paragraph  is  not  applicable  to  the  NTM  CPCI. 

4.3.4  Special  Features 

To  facilitate  the  testing  of  the  NTM  CPCI,  integrated 
application  processes  must  be  provided  to  act  as  test  drivers. 

4.3.5  Expandability 


4.3.1  Progr 


The  NTM  will  be  designed  and  implemented  in  a  manner  which 
provides  for  an  expandable  configuration  and  increasing 
functionality.  Additional  APs,  clusters,  hosts,  and  changes  in 
hardware  will  be  accommodated  with  minimal  impact  on  the  user 
and  the  system.  The  use  of  a  High  Order  Language  significantly 
enhances  the  portability  of  the  code.  Host  dependent  code  will 
be  used  only  when  absolutely  necessary.  In  these  cases  the  code 
will  be  identified  and  isolated  to  facilitate  transfer  to  a  new 
host . 

4.3.6  Special  Timing 

This  paragraph  is  not  applicable  to  the  NTM  CPCI. 

4.4  Human  Performance 


This  paragraph  is  not  applicable  to  the  NTM  CPCI. 
4.5  Data  Base  Requirements 


4.5.1  Sources  and 


es  of  Inputs 


The  information  identified  as  input  to  the  NTM  and  its 
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component  functions  is  defined  in  Section  4.2  above.  The 
identified  data  items  are  thoroughly  defined  in  Appendix  D 
below. 

4.5.2  Destinations  and  Types  of  Output 

The  information  identified  as  output  from  the  MTM  and  its 
component  functions  is  defined  in  Section  4.2  above.  The 
identified  data  items  are  defined  in  Appendix  D  below. 

4.5.3  Internal  Tables  and  Parameters 


The  tables  required  by  the  MTM  functions  are  discussed 
below.  The  structure  of  the  data  items  used  in  the  tables  are 
identified  in  the  IDEF1  model  in  Appendix  C  below.  These  items 
are  defined  in  Appendix  D  as  to  name .  ID.  description,  COBOL 
Picture,  size,  coding  type,  IDEF1  reference,  stability  (static 
vs.  dynamic),  legal  values,  source,  and  where  used. 

Figure  4-24  provides  an  overview  of  the  tables  used  by  the 

MTM. 
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Table 

Nauae 

Table 

ID 

Table 

Locat i on 

Entry 

Length 

Ho.  Of 
Entries 

Size 

Message 

Category 

Table 

(4.5.3. 1) 

CAT 

Global -IISS 

X(7) 

10 

70 

bytes 

Author i ty 
Table 

(4. 5. 3. 2) 

AUT 

Local  to 

APC  (Based 
on  resident  AP's 
authority  to  send) 

X(22) 

Variable 
per  table 
instance 

Vari¬ 

able 

AP  Informa¬ 
tion  Table 
(4. 5. 3. 3) 

API 

Local  to  APC 

X(  14) 

One  per 

AP  known 
to  IISS 

TBD 

( f i xed ) 

AP  Status 
Table 
(4. 5. 3. 4) 

APS 

Local  to  AP's 

AP  Cluster 

X(85) 

One  per  Var  i  - 

initiated  able 

AP  Instance 

Child  Table 
(4. 5. 3. 5) 

CLD 

Local  to  Parent 
AP's  AP  Cluster 

X(39) 

One  per 
spawned  AP 

Vari¬ 

able 

AP  Charac- 
istics  Table 
(4. 5. 3. 6) 

APT 

Local  to  AP's 

AP  Cluster 

X(24) 

One  per  AP 
on  APC 

TBD 

(fixed) 

APC  Status 
Table 

(4. 5. 3. 7) 

APC 

Global-IISS 

X(7) 

One  per 

APC  known 
to  IISS 

TBD 

( f i xed ) 

Host  Status 
Table 

(4. 6. 3. 8) 

HST 

Global-IISS 

X(7) 

3 

21 

bytes 

Message  Pairing 
Table  MPR 

(4. 5. 3. 9) 

Local  to  sending 
APC 

X(44  ) 

One  per 
»sg .  pair 

Vari¬ 

able 

Figure  4-24.  NTM  Tables  -  Overview 
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Table 

l&M 

Table 

ID 

Table 

Location 

Entry 

Length 

Mo.  of 
Entries 

Sise 

Logon  Table 
(4.5.3.10) 

LOG 

Local  to  Monitor 

AP  X(62) 

One 

per 

logged-on 

user 

Vari¬ 

able 

Guaranteed 

Delivery 

Table 

(4.5.3.11) 

GRD 

Local  to  sending 
APC 

X(66) 

One  per  Vari- 
Guar.  able 

Del . 

Msg .  sent 
from  on -APC 

AP 

AP  Operating  APO 

Information 

(4.5.3.12) 

Local  to  AP ' s 

AP  Cluster 

X(  19) 

One 

per 

AP  on  the 
APC 

Vari¬ 

able 

I  '■  Alive 

Table 

(4.5.3.13) 

IAT 

Local  to  AP's 

AP  Cluster 

X(  18) 

One  per  Vari  - 

AP  able 

instance  in 
Initiation 

Mode 

Link  Status 

Table 

(4.5.3.14) 

LST 

Local  to  Monitor 
AP 

X(3) 

One  per 
link 

9 

Authority 
Check  Table 
(4.5.3.15) 

ACT 

Local  to  APC 

X(9) 

One  per 
destina¬ 
tion  AP 

Vari¬ 

able 

Directory 

Table 

(4.5.3.16) 

DIR 

Global  IISS 

X(24) 

One  per  Var i - 

directory  able 
known 

to  the  IISS 

Connection 

Table 

COM 

Local  to  APC 

X(  ) 

One  per  Variable 
Connection 

(4.5.3.17) 


Figure  4-24.  NTM  Tables  -  Overview  (Continued) 
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4.5.3. 1  Wastage  Category  Table 

This  table  oontains  the  information  relative  to  the 
processing  required  of  the  MPU  in  order  to  move  a  ness age 
through  the  IISS.  The  categories  are  defined  primarily  in  terns 
of  these  processing  requirements.  A  seoond.  smaller, 
consideration  in  the  definition  of  the  categories  is  the 
breakdown,  to  a  limited  extent,  based  on  end  processing 
requirements.  This  breakdown  resulted  in  the  separate 
categorisation  of  8ystem  Commands  and  AP  Status  Messages. 

The  message  categories  defined  for  the  initial  Test  Bed 

are: 

A  Guaranteed  Delivery 

B  Response  required 

C  System  Command  -  no  response  (to  initiator) 

D  System  Command  -  response  (to  initiator)  required 

E  Unsolicited  Message 

F  Solicited  Message 

G  AP  Status  Message 

H  Initiation  Message  (may  or  may  not  have  data) 

I  Message  from  COMM  AP 

J  Initiation  Message  -  Response  Required 

The  format  and  identified  values  of  the  message  category 
table  are  shown  in  Figure  4-25.  The  individual  fields  are 
defined  below. 


Field 

Field  Name  Field  ID  Size 


Message  CAT-MSGCAT  X 

Category 


Author 1 sat i on  CAT- AUTREQ  X 

Requirement 


Field  Description 


This  field  contains  a  legal 
value  of  a  message  category. 
The  table  is  indexed  on  this 
field  using  the  value 
contained  in  the  message 
header . 

This  field  identifies 
whether  a  message  conforming 
to  a  given  category  requires 
authorization  at  it's  source 
AP  Cluster.  Authorization 
is  defined  as  the 
determination  that  the 
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Field 

Field  Name 

Field  ID 

Sise 

Field  Description 

destination  AP  is  in  faot 

able  to  reoeive  the  given 
message  type  from  the  source 
AP. 

Pairing 

CAT-PREQMT 

X 

This  field  identifies 

Requirement 

whether  a  message  conformed 
to  a  given  message  category 
requires  pairing. 

Guaranteed 

CAT-GUARDL 

X 

This  field  identifies 

Delivery 

whether  a  message  conforming 
to  a  given  message  category 
requires  that  an 
acknowledgement  of  delivery 
be  sent  to  the  souroe  of  the 
message. 

Message 

CAT-MSGPRY 

X 

This  field  indicates  the 

Priority 

level  of  priority  assigned 
to  a  message  conforming  to  a 
given  message  category. 

The  value  of  this  field  is 

added  to  the  message  header 
by  the  MPU. 

Log 

CAT-LOGREQ 

X 

This  field  indicates  whether 

Requirement 

logging  is  required  on  a 
message  conforming  to  the 
given  category.  The  value  is 
added  to  the  message  header 
by  the  MPU. 

Statistics 

CAT-STATCO 

X 

This  field  indicates  whether 

Col  lection 

statistics  are  to  be 

Flag 

collected  on  a  message  con¬ 
forming  to  the  given  message 
category.  The  value  is  added 
to  the  message  header  by  the 
MPU. 
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Author i-  Pairing  Log 

Message  sation  Require-  Guaranteed  Message  Require-  Statistics 

Category  Requirement  Bent  Delivery  Priority  ment  Collection 


A 

Tes 

Mo 

Yes 

Low 

Yes 

Yes 

B 

Tes 

Yes 

Mo 

Low 

Yes 

Yes 

C 

Mo 

Mo 

Mo 

High 

Yes 

Yes 

D 

No 

Yes 

Mo 

High 

Yes 

Yes 

E 

Tes 

Mo 

Mo 

Low 

Yes 

Yes 

F 

Mo 

Yes 

Mo 

Low 

Yes 

Yes 

G 

Mo 

Mo 

Mo 

Low 

Yes 

Yes 

H 

Yes 

Mo 

Mo 

Low 

Yes 

Yes 

I 

Mo 

Yes 

Mo 

Low 

Yes 

Yes 

J 

Yes 

Yes 

Mo 

Low 

Yes 

Yes 

Figure  4-25.  Message  Category  Table 
4. 5. 3. 2  Authority  Table 

Authority  is  defined  as  the  fact  that  a  given  destination 
is  able  to  receive  a  given  message  type  from  a  given  source.  In 
order  for  a  message  to  be  authorised,  the  message  type,  message 
source,  and  message  destination  values  given  in  the  message 
header  must  match  with  a  legal  combination  given  in  the 
authority  table. 

The  authority  table  is  aocessed  where  the  Authority  Check 
Table  (Section  4.5.3.15)  indicates  that  an  authority  check  is 
required  on  the  given  message.  The  table  is  indexed  by  the 
Message  Source  although  all  three  values  (Source,  Type,  and 
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Destination)  nust  exist  in  the  sane  unique  tuple  in  the  table. 

The  fields  of  the  Authority  Table  are  briefly  described 
below. 


Field 

Field  Marne 

Field  ID 

Size 

Field  Description 

Authorized 

AUT-ATOREC 

X(10) 

Identifies  one  instance  of  a 

to  Receive 

legal  destination  that  is 
allowed  to  receive  a  given 
nessage  type  from  a  given 
source.  The  value  in  this 

field  will  be  replicated  for 
each  tuple  in  which  the 
given  destination  is 
involved. 

Message  Type 

AUT-MSGTYP 

X(2) 

Identifies  one  instance  of  a 

given  nessage  type.  The 
value  in  this  field  will  be 
replicated  for  each  tuple  in 
which  the  given  ne6sage  type 
is  involved. 

Authorized  AUT-ATOSND  X(10)  Identifies  one  instance  of  a 
to  Send  send  legal  source  that  is 

allowed  to  send  a  given 
message  type.  The  value  in 
this  field  will  be  re¬ 
plicated  for  each  tuple  in 
which  the  given  source  is 
involved. 

4. 5. 3. 3  Application  Process  Information  Table 

This  table  contains  data  relative  to  any  given  Application 
Process.  This  information  is  always  available  for  routing 
purposes . 

For  this  purpose,  the  table  provides  the  name  of  the  AP 
Cluster  that  a  given  destination  AP  resides  on.  (The  physical 
location  of  any  AP  is  deliberately  invisible  to  any  other  AP  in 
order  to  provide  naucimum  flexibility  in  the  assignment  of  AP's 
to  AP  Clusters).  The  destination  AP  name  from  the  message 
header  must  be  mapped  to  it's  AP  Cluster  via  a  table  lookup. 
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The  destination  AP's  AP  Cluster  is  added  to  the  header  when  it 
is  found  in  the  table. 

Then  the  aessa ge  is  routed,  the  MPU  checks  the  destination 
AP  Cluster  field.  As  eaoh  MPU  knows  who  it  is,  the 
deteraination  can  easily  be  aade  as  to  whether  the  aessage  is  to 
be  sent  on  or  off  AP  Cluster.  If  the  destination  is  off-AP 
Cluster,  a  lookup  is  aade  in  the  AP  Cluster  status  table 
(Section  7)  to  deteraine  the  host  the  AP  Cluster  is  currently 
residing  on.  Again,  the  MPU  can  reoognise  it's  own  host  and  can 
therefore  deteraine  whether  the  destination  is  on  or  off  host. 
Where  the  destination  is  off-host,  the  aessage  is  routed  to  the 
destination  host's  COMM  AP  Cluster.  Where  the  aessage 
destination  is  on-host,  the  aessage  is  routed  directly  to  the 
destination  AP  Cluster. 

The  foraat  and  identified  values  of  the  AP  Inforaation 
Table  are  shown  in  Figure  4-26.  Each  field  i6  described  below. 

Field 

Field  Mane  Field  ID  Sise  Field  Description 


AP  Maae  API-APMAME  X(10)  This  field  contains  the  naae 

of  a  callable  entity  within 
the  IISS.  It  is  the  key 
field  of  the  table  and  is 
accessed  by  Batching  the  AP 
naae  contained  in  the 
destination  field  of  the 
aessage  header. 

This  field  contains  the  naae 
of  the  AP  Cluster  upon  which 
the  given  AP  naae  resides. 
The  value  in  this  field  aay 
serve  as  a  key  value  should 
the  need  arise  to  access  the 
AP  Cluster  status  table. 

This  field  identifies  the 
type  of  chaining  support 
required  by  the  AP.  This 
support  may  be  child 


AP  Cluster  API-APCNME  X(3) 
Maae 


Queue  Server  API-QSTYPE  X 
Type 


4-111 


'V.V.V.yM 


DS  630142000 
1  Moveaber  1985 


Field  Mane  Field  ID  Size  Field  Description 


chaining,  Message  chaining, 
or  no  chaining. 


4. 5. 3. 4  Application  Process  Status  Table 

This  table  contains  dynamic  data  associated  with  an  AP  that 
has  been  initiated.  An  entry  is  oreated  when  an  AP  instance  is 
initiated  and  is  maintained  until  the  AP  instance's  tree  status 
indicates  that  the  AP  instance  and  all  associated  instances  are 
terminated  and  cleaned  up. 

The  table  further  provides  the  data  needed  to  maintain  the 
tree  of  AP's  spawned  by  the  given  AP  instance  entry.  This  tree 
is  kept  to  facilitate  the  logic  needed  to  perform  an  Abort  and 
to  cleanup  after  any  kind  of  termination. 

The  individual  fields  of  the  AP  Status  Table  are  described 


below. 

Field  Name 

Field  ID 

Field 

Sise 

Field  Description 

A PC  Name 

APS-APCNME 

X(3) 

This  field  contains  the  name 
of  the  A PC  on  which  the  AP 
resides . 

AP  Name 

APS-APNAME 

X(10) 

This  field  contains  the  AP 
name  of  the  initiated  AP. 

Instance 

APS-INSTNC 

X(2) 

This  field  contains  the 
identifier  of  the  specific 
instance  of  the  initiated 

AP. 

Original 

Source 

APS-ORQSRC 

X(  15) 

This  field  contains  the  AP 
name  Instance,  and  resident 
AP  Cluster  of  the  ultimate 
originator  of  the  AP.  In 
the  case  of  a  spawned  AP, 
the  originating  source  is 
the  AP  that  sent  the 
transaction  that  "fired  off” 
the  AP  at  the  top  of  the 
tree . 
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Field  I&M 


Iaaediate 

Parent 


Field  ID 


Field 

Sise 


AP8-IMMPAR  X( 15) 


Child  Table  APS-CLDIHD  9(4) 


Message  Queue  APS-MSGQOF 
Flag 


Field  Description 


This  field  contains  the  AP 
name.  Instance,  and  resident 
AP  Cluster  of  the  AP  that 
sent  the  transaction  that 
"fired  off"  the  given  AP 
instance.  The  value  in  this 
field  nay  natch  the  value  of 
originating  source. 

This  field  points  to  the 
AP's  first  Index  Entry  in 
the  Child  Table.  (The  Child 
Table  is  discussed  in 
Section  4.5.S.5) . 

This  field  indicates  whether 
there  are  nessages  waiting 
for  the  AP  in  the  message 
queue. 
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Field 

Field  Name  Field  ID  Size 


Pair  Flag  APS-PRFLAG  X 


AP  Status  APS-APSTAT  X 


Message  Serial  APS-SERHLQ  X(10) 
Last  Queued 


Guaranteed  APS-GDFLAG  X 

Del ivery 

Flag 


Number  of  APS-NOCONN  X(2) 
Connections 


Field  Description 


This  field  Indicates  whether 
the  given  AP  instance  has 
one  or  more  outstanding 
waits.  If  the  AP  does  not 
have  any  paired  msgs 
outstanding,  the  flag  will 
be  null.  The  Message 
Pairing  Table  is  discussed 
in  Section  9. 

This  field  provides  the 
current  structure  and 
operating  status  of  the  AP 
and  its  “tree"  of  AP's 
spawned  by  the  given  AP. 

The  Serial  «  and  source  AP 
Cluster  of  the  last  message 
placed  in  the  AP  instance's 
queue.  This  information 
will  be  used  to  recover  the 
6tate  of  the  AP. 

This  field  indicates  whether 
the  given  AP  has  one  or  more 
guaranteed  delivery  mes¬ 
sages  outstanding.  The 
Guaranteed  Delivery  table  is 
discussed  in  Section  11. 

This  field  Indicates  the 
current  number  of  sources 
that  are  currently  connected 
to  an  instance  of  a  Queue 
Server.  Where  the  given  AP 
is  not  a  Queue  Server,  this 
field  will  be  nul 1 . 

This  field  identifies  the 
logical  channel  under  which 
the  given  AP  instance  was 
initiated . 


Logical 
Channe 1  ID 


APS-CHANID  X( 3 ) 
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• 

• 

Field  Ism 

Field  ID 

Field 

Sime 

Field  Description 

<0 

Chi ldren 

APS-CHLDRM 

Z 

This  field  indicates  whether 
the  given  AP  has  any  ohild 
AP's  associated  with  it. 

Message  In 
Queue 

APS-MMSA 

X(4) 

Identifies  the  Humber  of 
Messages  in  Queue  for  the 

AP. 

Last  Key 
Pointer 

APS-LSTKEY 

X(9) 

Pointer  to  the  last  key 

value  for  the 

given  AP  in  the  AP  Queue 

Table. 

First  Pseudo 
Instance 

APS-FPIHST 

Z 

This  field  points  to  the 
first  entry  in  the 

Connection  Table  for  the 
given  AP. 

Last  Pseudo 
Instance 

APS-LPIMST 

z 

This  field  contains  the  last 
Pseudo  Instance  number 
assigned  to  the  AP. 

4. 5. 3. 5  Child  Table 


One  instance  of  a  child  table  is  used  to  maintain  one  level 
of  the  tree  of  chained  AP's.  This  table  is  in  effect  a  linked 
list  of  AP's  spawned  by  a  common  parent.  This  parent  nay  also 
be  a  child  AP  itself.  The  table  has  an  entry  for  every  instance 
of  an  AP  spawned  by  an  on-WS  AP. 

The  child  table  is  acoessed  when  the  parent  is  abnormally 
terminated  (aborted)  in  order  to  abnormally  terminate  any  AP's 
that  were  spawned  by  the  parent.  As  a  child  AP  nay  also  be  a 
parent  AP,  its  children  would  also  be  abnormally  terminated. 

The  table  is  also  used  to  facilitate  cleanup  on  any  termination 
(normal  or  abnormal). 

The  fields  of  the  Child  Table  are  described  below. 
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Field 

Field 

Field  Marne 

ID 

Size 

Field  Description 

Child  AP 
Cluster 

CLD-APCNME 

X(3) 

This  field  contains  the  name 
of  the  AP  Cluster  that  the 
child  AP  resides  on. 

Child 

Parent 

CLD-PARNME 

X(12) 

The  Process  Name  of  the 
child  AP's  parent. 

Child  Rank 

CLD-RANK 

9(4) 

The  ranking  assigned  to  the 
child  AP  when  the  table 
entry  is  made. 

Child  AP 

Mane 

CLD-APNAME 

X(10) 

This  field  contains  the  AP 
Name  of  the  spawned  AP. 

Child  Status 

CLD-CLDSTS 

X 

The  child  status  indicates 
the  operational  status  of 
the  child  AP. 

Next  Sibling 
Index 

CLD-NXTSIB 

9(4) 

This  field  provides  an  index 
to  the  next  child  AP  spawned 
by  the  common  parent  AP. 

Logical 
Channel  ID 

CLD-CHANID 

X(3) 

This  field  identifies  the 
logical  channel  under  which 
the  given  Child  AP  was 
spawned. 

Reserved 

Code 

CLD-RESCDE 

X 

This  field  indicates  whether 
the  entry  is  confirmed  or 
reserved. 

Number 

Tries 

CLD-CTRIES 

X 

This  field  indicates  how 
long  the  entry  has 
been  reserved.  At  a  given 
point,  a  reserved  entry  will 
be  deleted. 

4. 5. 3. 6  AP  Characteristics  Table 

This  table  provides  the  processing  characteristics  of  a 
given  AP  in  accordance  with  it's  type.  The  table  is  used  to 
determine  how  to  handle  a  given  AP  on  the  occurrence  of  various 
events.  As  the  characteristics  of  an  AP  are  not  directory 
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Field  Name 

Field  ID 

Sise 

Field  Description 

AP  Name 

APT-APNAME 

X(8) 

The  AP  Name  of  the  given  AP. 
This  field  serves  as  the  key 
to  the  table. 

Maxi eua  Number  APT-NOAMSG 
Queued 

Messages 

X(2) 

The  maximum  number  of  of 
messages  allowed 
in  the  AP's  queue  at  any  one 
time. 

Maximum 

Instances 

APT-MAXINS 

X(2) 

Thi6  field  defines  the 
maximum  number  of  instances 
of  the  given  AP  that  can  be 
awake  at  any  one  time. 

Number  of 
Parents  per 
Instance 

APT-NOPINS 

X(2) 

The  maximum  number  of 
parents  allowed  to  one 
instance  of  the  AP  at  any 
one  time 

Initiation 

Needs 

APT-INIHDS 

X 

This  field  identifies 
whether  the  AP 
requires  a  specific 
initiation  message  or  can  be 
started  by  any  kind  of 
message . 

On  Abort 

APT-ONABT 

X 

This  field  indicates  how  the 
given  AP  is  to  be  handled 
when  an  Abort  message 
arrives  for  it. 

Number  of 

Mai  1 boxes 

APT-NUMMBX 

X 

This  field  indicates  the 
number  of  mailboxes  an  AP 
will  support. 

On -Shutdown 

APT-ONSTDN 

X 

This  field  indicates  whether 
the  given  AP  has  the 
internal  logic  to  handle 
shutdown . 

On-Recovery 

APT-ONREC 

X 

This  field  indicates  whether 
the  given  AP  has  the 
internal  logic  to  handle 
recovery . 
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Field 


Field  Marne 

Field  ID 

Size 

Field  Description 

On-Chi Id 

normal 

Termination 

APT-OHCLDT 

X 

This  field  indioates  how  the 
given  AP  is  to  be  treated 
upon  the  normal  termination 
of  a  child  AP. 

On-Child 

Abnormal 

Termination 

APT-OHCLDA 

X 

This  field  indicates  how  the 
given  AP  Abnormal  is  to  be 
treated  upon  the  Abnormal 
Termination  of  a  child  AP. 

On-Child 

Shutdown 

APT-ONCLDS 

X 

This  field  indicates  how  the 
given  AP  is  to  be  treated 
upon  the  shutdown  of  a  ohild 
AP. 

Timeout 

Handl lng 

APT-TMOHDL 

X 

This  field  contains  a  code 
which  represents  how  the 
given  AP  is  to  be  handled  in 
the  even  of  a  timeout 
expiration. 

AP  Priority 

APT-APPRTY 

X 

This  field  provides  the 

priority  level  of  the  given 
AP. 


specific,  the  directory  prefix  is  not  used  in  this  table. 

The  fields  of  the  AP  Characteristics  Table  are  briefly 
described  below. 

4. 5. 3. 7  AP  Cluster  Status  Table 

This  table  serves  to  identify  both  the  location  of  a  AP 
Cluster  within  the  IXSS  and  its  current  operating  status. 

The  table  is  accessed  primarily  for  routing  purposes  in 
order  to  determine  if  the  destination  of  a  given  message  is  on 
or  off  host.  The  table  may  also  be  used  to  check  the  status  of 
a  destination  AP  Cluster  prior  to  sending  a  message. 

Each  field  of  the  AP  Cluster  Status  Table  is  defined  below. 
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Field  Name 

Field 

ID 

Field 

Sise 

Field  Description 

AP  Cluster 
Name 

APC-APCNME 

X(3) 

This  field  is  the  key  to  tb 
table.  It  identifies  an 
instance  of  a  AP  Cluster  on 
the  IISS. 

AP  Cluster 
Status 

APC-APCSTS 

X 

This  field  identifies  the 
current  operational  status 
of  the  given  AP  Cluster. 

AP  Cluster 
Logical 

Host 

APC-HSTNAM 

X(3) 

This  field  identifies  the 
logioal  host  machine  within 
the  IISS  that  the  given 

AP  Cluster  resides  on. 

4. 5. 3. 8  Host  Status  Table 

This  t&ble  serves  to  provide  the  current  operational  status 
of  a  host  machine  on  the  IISS.  It  is  called  out  as  a  separate 
table  in  order  to  provide  the  flexibility  of  adding  more  host 
specific  data  in  the  future. 

The  fields  of  the  Host  Status  Table  are  described  below. 


Field  Name 

Field 

ID 

Field 

Size 

Field  Description 

Logical 

Host  Name 

HST-HSTNAM 

X(3) 

This  field  is  the  key  to  the 
table.  It  identifies  an 
instance  of  a  logical  host 
machine  on  the  IISS. 

Host  Status 

HST-HSTSTS 

X 

This  field  identifies  the 
current  operational  status 
of  the  given  physical  host. 

Physical 

Host  Name 

HST-PHYHST 

X(  3) 

This  field  maps  the  given 
logical  host  name  to  it's 
physical  host  name. 
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4. 5. 3. 9  Message  Pairing  Table 

The  message  pairing  table  serves  to  track  a  given  dialog 
between  APs  on  the  IISS  system.  Messages  conforming  to 
categories  requiring  pairing  services  (category  B,  D.  F,  and  J) 
will  be  tracked  via  this  table. 

When  a  message  conforming  to  Category  B,  D,  or  J  is 
generated  on  a  AP  Cluster,  an  entry  will  be  made  in  the  table 
for  that  AP  Cluster.  A  timeout  will  be  set  on  the  pair,  its 
duration  to  be  either  user  defined  or  a  system  wide  default 
value.  Should  a  message  conforming  to  Category  F  come  into  the 
AP  Cluster  before  the  timeout  period  expires,  it  will  be  matched 
to  an  existing  entry  in  the  table  based  on  the  original  source 
and  channel  ID  fields  in  the  two  messages.  When  a  match  is 
made,  it  will  constitute  a  post  thereby  canceling  the  wait,  the 
timeout,  and  the  entry  in  the  table.  Should  the  timeout  expire 
before  a  post  is  set.  the  wait  will  be  cancelled  and  should  the 
Category  F  message  arrive  after  the  fact,  it  will  be  rejected. 

The  overall  purpose  of  this  table  is  to  provide  the  status 
of  paired  messages  to  the  originating  source  of  the  request  upon 
the  occurrence  of  three  significant  events;  the  setting  of  a 
post;  the  expiration  of  the  timeout;  or  upon  a  paired  message 
status  request  from  the  NTM  system  services. 

The  fields  of  the  Message  Pairing  Table  are  described 


below. 

Field  Name 

Field 

ID 

Field 

Size 

Field  Description 

Paired 
Message  APC 

MPR-APCNME 

Name 

X(  3 ) 

Identifies  the  source  APC  of 
the  paired  message. 

Original 
Source  AP 

MPR-MSGSRC 

X(  1 5  ) 

This  field  contains  the 
source  of  the  "request''  end 
of  the  message  pair. 

Timeout 

Time 

MPR-TMOUTM 

X(  23) 

This  field  contains  the 
system  clock  time  when  the 
timeout  on  the  given  message 
expires . 

Logical 
Channel  ID 

MPR-CHANID 

X(  3) 

Identifies  the  logical 
channel  under  which  the 
paired  message  was  sent. 
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4.5.3.10  Log-On  Table 

The  Log-on  Table  will  maintain  information  regarding  the 
human  users  ourrently  logged  on  to  the  1ISS.  The  data  will  be 
supplied  to  the  aonitor  AP  by  the  User  Interface  upon  successful 
Log-on.  The  NTH  will  have  no  awareness  of  an  unsuccessful 
logon. 

The  fields  of  the  Logon  Table  are  described  below. 


Field  Name 

Field 

ID 

Field 

Sise 

Field  Description 

UI(AP)Name 

LOG-APNAME 

X(10) 

This  field  contains  the  AP 
Name  of  the  AP  Cluster  naae 
of  the  UI  where  the  given 
user  is  logged  on. 

APC  Name 

LOG-APCNME 

XC3) 

Identifies  the  AP  Cluster 
that  the  given  UI  AP  resides 
on. 

Terainal  ID 

LOG -TERM ID 

X(2) 

This  field  identifies  the 
terainal  where  the  given 
user  i6  logged  on.  This  is 
the  instance  of  the  UI(AP) 
Name . 

User  Name 

LOG-USRNAM 

X(8) 

This  field  contains  the  User 
Name  of  the  user  logged  on 
at  the  given  AP  instance. 

Role  Name 

LOG-ROLENM 

X(10) 

This  field  identifies  the 
role  under  which  the  given 
user  is  logged  on. 

Session 

Start  Tiae 

LOG-STRTME 

X(  23) 

This  field  contains  the 
system  clock  tiae  when  the 
given  user's  logon  request 
was  accepted . 

Channe 1 

Range  Start 

LOG-CHANST 

X(3) 

The  lowest  Logical  Channel 

ID  in  the  range  of  ID's 
allocated  to  the  user  at 
logon . 
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Field 

Field 

Field  Name 

ID 

Sine 

Field  Description 

Channel 

LOG-CHANED 

X(3) 

The  highest  Logical  Channel 

Range  End 

ID  in  the  range  of  ID's 

allocated  to  the  user  at 
logon. 


4.5.3.11  Guaranteed  Delivery  Table 

This  table  is  used  to  record  all  guaranteed  delivery 
messages  that  originate  on  a  given  AP  Cluster.  The  table  is 
used  to  provide  the  age  of  a  message  to  ensure  that  it  does  not 
remain  on  the  system  forever. 

The  fields  of  the  Guaranteed  Delivery  Table  are  described 
below. 


Field  Name 

Field  ID 

Field 

Sime 

Message 

Source 

GRD-MSGSRC 

X(  15) 

Message 

Serial 

Number 

GRD-MSGSN 

X(7) 

Time  Stamp 
When  Accepted 

GRD-TSTAMP 

X(  23) 

Message 

GRD-MSGDST 

X(15) 

Destination 


Field  Description 


This  field  contains  the  AP 
Name,  instance  identifier 
and  work-station  of  the  AP 
that  sent  the  guaranteed 
delivery  message. 

This  field  contains  the 
serial  number  that  was 
assigned  to  the  message  by 
the  MPU. 

This  field  contains  the  time 
when  the  given  guaranteed 
delivery  message  was 
accepted  by  the  source  MPU 
as  a  valid  IISS  message. 

This  time  provides  the  base 
for  determining  the  age  of 
the  message. 

This  field  contains  the  AP 
Name  and  AP  Cluster  of  the 
destination  AP  as  specified 
in  the  header  of  the 
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Field 

Field  Mane  Field  ID  Sise  Field  Description 


guaranteed  delivery  message. 

Pointer  to  GRD-MFHPTR  X(6)  This  field  points  to  the 
Message  File  file  in  non-volatile  memory 

where  the  given  guaranteed 
delivery  message  has  been 
Journalised. 
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4.5.3.12  AP  Operating  Information  Table 

This  table  provides  the  current  operational  information 
about  a  generic  AP  (as  opposed  to  a  specific  instance  of  it). 

The  fields  of  the  AP  Operating  Information  Table  are 
defined  below. 


Field  Name 

Field  ID 

Size 

Field  Description 

APC  Name 

APO-APCNME 

X(3) 

The  name  of  the  APC  that  the 
active  AP  resides  on. 

AP  Name 

APO-APNAME 

X(8) 

This  field  in  combination 
with  the  APC  name  is  the  key 
to  the  table. 

Instances 

Currently 

Running 

APO-NUMINS 

X(2) 

This  field  provides  the 
number  of  instances  of  the 
given  AP  that  are  currently 
in  operation. 

Last  Instance 

Number 

Assigned 

APO-LSTINS 

9(4) 

This  field  provides  the  last 
instance  number  assigned  to 
an  instance  of  the  given  AP. 

Number  of 
Messages 

APO-NUMMSG 

X(2) 

This  field  indicates  the 
number  of  messages  in  the 
message  queue  that  are 
waiting  for  the  given  AP. 

4.5.3.13  I'm 

Alive  Table 

This  table  is  used  to  track  AP's  that  have  been  initiated 
but  are  not  yet  running.  As  each  entry  will  be  maintained  for  a 
limited  amount  of  time  («  of  tries)  it  also  insures  that  an 
initiation  problem  is  detected. 

The  fields  are  defined  below. 


Field  Name 

Field  ID 

Field 

Size 

Field  Description 

APC  Name 

IAT-APCNME 

X(  3) 

The  APC  of  the  AP  being 

initiated . 
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• 

Field  Marne 

Field  ID 

Field 

Size 

Field  Description 

» 

* 

AP  Marne 

IAT-APMAME 

X(10) 

The  name  of  the  AP  being 
initiated. 

Instance 

IAT-IMSTNC 

X(2) 

The  instance  ID  assigned  to 
the  given  AP  being 
initiated. 

ACK  to  Source 
MPU 

IAT-MPUACK 

X 

Identifies  whether  the 
message  causing  the 
initiation  conforms  to 
Category  E  thereby  requiring 
an  ACK  to  be  sent  to  the 
source  MPU  upon  AP 
initiation. 

Data  Code 

IAT-DATACD 

X 

Indicates  whether  there  is 
data  waiting  for  the  given 
AP. 

Mumber  of 
Tries 

IAT-NTRIES 

X 

Tracks  the  number  of  times 
the  entry  has  been  checked 
against  the  AP  Status  Table. 

4.5.3.14  Link  Status  Table 

The  Link  Status  Table  provides  the  current  operational 
status  of  the  link  between  two  given  physical  host  machines. 

The  fields  of  the  Link  Status  Table  are  defined  below. 


Field 

Name 

Field  ID 

Field 

Size 

Field  Description 

Link 

ID 

LST-LINKID 

X(  2) 

Identifies  a  specific  link 
between  two  host  machines  on 
the  IISS. 

Link 

Status 

LST-LKSTAT 

X 

The  current  status  of 
g i ven  link. 

the 
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4.5.S.15  Author ity  Check  Table 

This  table  provides  an  authority  precheck  for  messages 
conforming  to  categories  requiring  authorisation.  This  is  due  to 
the  situation  where  the  message  implies  authorisation  but  the 
destination  AP  has  waived  the  requirement.  This  allows  the  AP 
developer  the  right  to  either  restriot  access  to  the  AP  (on 
those  messages  requiring  authorisation)  or  to  open  the  AP  to  any 
and  all  sources.  Where  access  i6  restricted,  the  AP  developer 
will  inform  the  CDM  Administrator  as  to  the  sources  allowed 
access  and  the  message  types  accepted.  This  information  will  be 
contained  in  the  authority  table. 

The  Authority  Check  Table  will  be  accessed  by  the  MPU  on 
all  messages  requiring  authorisation.  Where  the  destination 
access  is  open,  the  MPU  will  continue  message  management 
processing.  Where  the  destination  access  is  restricted,  the  MPU 
will  proceed  to  check  the  message  against  the  Authority  Table  as 
described  in  Section  4.5. 3.2.  At  present,  the  authority  check 
is  not  concerned  with  the  directory  the  AP  is  in. 

The  Authority  Check  Table  fields  are  described  below. 


Field  Name 

Field  ID 

Field 

Sise 

Field  Description 

(Destination) 
AP  Name 

ACT-APNAME 

X(8) 

The  key  field  in  the  table. 
The  Destination  AP  Name  from 
the  header  is  matched  to  an 
entry  in  this  field. 

Access  Flag 

ACT-ACCFLG 

X 

Identifies  whether  the 
access  to  the  destination  AP 

(on  messages  requiring 
authorisation)  is  restricted 
or  open. 


4.5.3.16  Directory  Table 

This  table  provides  the  link  between  a  directory  prefix  and 
the  directory  name  to  which  it  refers.  The  use  of  the  directory 
prefix  allows  an  AP's  executable  module  to  be  located  in  a 
directory  other  than  the  directory  in  which  the  1ISS  is  run. 

The  directory  prefix  is  used  in  all  AP  Interface  service 
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calls  as  a  given  AP  nay  exist  as  different  versions  in  different 
directories  (i.e.,  production  version  vs.  test  version).  AP's 
having  the  sane  base  (5  character)  name  mist  adhere  to  a  couon 
set  of  characteristics  regardless  of  the  number  of  versions  in 
existence. 

The  individual  fields  of  the  directory  table  are  defined 
below. 


Field  Name 

Field  ID 

Field 

Size 

Field  Description 

Directory 

Prefix 

DIR-PREFIX 

X(2) 

The  identifier  assigned  to  a 
given  directory.  This  ID  is 
used  as  part  of  the  AP's 
name  when  the  AP's  directory 
must  be  known. 

Directory 

Name 

DIR-DIRNHE 

X(20) 

The  name  of  the  directory 
identified  by  the  prefix. 
This  field  includes  the 
brackets  and  period. 

Directory 

Length 

DIR-NHELEN 

X(2) 

The  length  in  bytes  of  the 
directory  name  including  the 

period  but  excluding  the 
brackets . 


4.5.3.17  Connection  Table 

The  NTH  supports  AP's  known  as  Queue  servers.  Within  the 
type  queue  server  are  the  sub-types  of  multiple-parent  or 
single-source.  As  these  AP's  may  serve  a  number  of  source  AP's 
during  a  single  run,  they  cannot  be  tracked  by  the  current  NTH 
child  chaining  mechanism.  As  a  result,  the  geneology  of  a  given 
source  AP  will  be  broken  when  the  path  encounters  a  queue 
server.  In  order  to  maintain  this  geneology.  the  NTH  will, 
given  the  characteristic  of  an  AP  requiring  Hessage  chain 
support,  track  (chain)  a  message  at  the  point  at  which  it 
encounters  a  queue  server . 

In  order  to  handle  the  tracking  of  messages  at  a  queue 
server  AP,  an  entry  will  be  made  in  that  AP's  connection  table. 
This  entry  establishes  a  “Pseudo"  Instance  or  connection  which 
is  considered  to  be  a  separate  instance  of  the  AP.  The 
connection  table  entry  contains  values  pertinent  to  the 
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particular  connection  as  opposed  to  the  AP  instance  itself. 
Therefore,  in  one  AP  instance  there  may  be  two  connections,  one 
of  which  has  child  AP's  and  one  which  may  not.  In  this  manner, 
the  geneology  may  be  traced  beyond  a  queue  server. 

As  for  the  child  table,  the  connection  table  is  maintained 
as  a  linked  list  with  a  pointer  from  the  AP's  table  to  the  first 
entry  for  the  AP. 

The  individual  fields  of  the  connection  Table  are  described 
below. 


Field  Name 

Field  ID 

Field 

Size 

Field  Description 

Pseudo 

Instance 

CON-PINST 

X 

Identifies  the  Pseudo 
instance  assigned  to  the 
given  connection.  This 
value  may  also  be  carried  in 
the  APs  table  to  provide  a 
pointer  into  the  connection 
table. 

Client  Name 

CON-CLNAME 

X(10) 

The  name  of  the  source  AP  of 
the  given  connection. 

Client  Pseudo 
Instance 

CON-CLPINS 

X 

The  pseudo  instance  of  the 
source  AP  is  included  if  the 
source  AP  is  also  a  queue 
server.  If  the  source  is 
not  a  queue  server  this 
field  will  be  blank. 

Child  Rank 

CON-CLDRNK 

9(4) 

As  in  the  APs  table,  this 
field  points  to  the  first 
child  entry  associated  with 
the  given  connection. 

Pair  Flag 

CON-PRFLG 

X 

Indicates  whether  the  given 
connection  has  outstanding 
paired  messages. 

Chi ldren 

CON -CHILD 

X 

Indicates  whether  the  given 

connection  has  any  child 
AP's  associated  with  it. 
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Field  Marne 

Field  ID 

Field 

Sine 

Field  Description 

Connection 

Channel 

GOM-CORCKM 

X(3) 

The  channel  ID  from  the 
message  that  established  the 
given  connection. 

Mext 

Connection 

00M-MXT00M 

X 

Pointer  to  the  next  Pseudo 
instance  associated  with  the 

Queue  Server  AP.  The  end  of 
the  chain  is  indicated  where 
the  last  pseudo  instance 
points  to  itself. 

4.6  Adaptation  Requirements 

The  NTH  aust  be  compiled,  linked  and  installed  on  each  host 
in  the  IISS  Test  Bed.  The  Test  Bed  consists  of  a  VAX-11/780  (VMS 
operating  systen),  IBM  30S3  (CICS  under  MVS  SP1 . 1  operating 
system)  and  Honeywell  Level  6  (GC0S400  operating  system). 

HTM  modules  that  are  machine  specific  must  be  included  in 
the  IISS  system  built  on  each  host.  As  a  goal  it  would  be 
desirable  to  have  the  host  specific  statements  conditionally 
compiled  or  assembled  based  on  host  type  input.  Adding  a  new 
host  type  requires  writing  these  machine  specific  modules  for 
that  host. 

4.7  Government  Furnished  Property  List 

This  paragraph  is  not  applicable  to  the  NTM  CPCI . 
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SECTION  S 

QUALITY  ASSURANCE  PROVISIONS 


5.1  Introduction  and  Definition 

The  NTH  Quality  Assurance  will  be  coordinated  with  the  IISS 
integration  contractor.  General  Electric  Company,  to  ensure  that 
it  supports  the  QA  needs  for  the  IISS. 

The  philosophy  of  Quality  Assurance  involves  more  than 
simply  testing  code.  QA  begins  with  Requirements  Definition  and 
continues  throughout  the  System  life  Cycle.  Quality  assurance 
provisions  involve  software  engineering  standards,  tools, 
methodologies,  procedures,  guidelines,  and  control  mechanisms. 
Procedures  and  guidelines  for  testing  are  of  particular 
importance  in  the  assuranoe  of  a  quality  product. 

Testing  of  NTH  code  will  oeour  at  two  levels.  First,  unit 
level  tests  will  be  performed  by  NTH  developers  for  each  major 
portion  of  code  to  detect  coding  errors  and  errors  resulting 
from  the  interaction  of  modules.  Unit  level  testing  will  take 
place  for  each  release  of  the  NTM.  Second,  NTH  developers  will 
support  General  Electric  in  IISS  Test  Bed  Integration  Testing 
for  each  IISS  release. 

Integration  testing  will  be  done  on  the  IISS  Test  Bed 
facilities  provided  for  that  purpose  by  General  Electric. 


DS  620142000 
1  November  1985 


5.2  Computer  Programming  Test  and  Evaluation 
5.2.1  Test  Approach 

Testing  of  code  is  driven  by  scenarios  written  to  reflect 
the  requirements  stated  in  Section  4  of  this  document.  Figure 
5-1  provides  a  matrix  of  requirements  to  test  cases.  The 
specific  tests  are  described  in  detail  in  Section  5.2.4.  The 
implementation  of  these  scenarios  include  small  integrated  test 
AP's  having  the  characteristics  noted  in  the  scenarios.  The 
scenarios  include  (but  are  not  limited  to): 

e  Startup  Host 

e  Startup  IISS 

e  Accept  Logon  message  from  01 

e  Initiate  an  AP  using  CALL  " I SEND" 

•  Initiate  an  AP  using  CALL  "NSEND" 

e  Maintain  the  status  of  an  AP  from  initiation 

through  normal  termination 
e  Abort  an  AP  from  an  Operator  Command 

e  Accept  Logoff  message  from  01 

e  Build  NTH  tables  from  file 

•  Hand i 3  host  to  host  communications  between  AP's 

e  Shutdown  Host 

•  Shutdown  IISS 


i 
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4. 1.2.1 


NTM  DS  Recruiremei 

Interface  to  Mew  AP's 

(System  Services) 
INITAL 
I  SEND 
NSEND 
RCV 

TRMNAT 

GETUSR 

CHKMSG 

GDSEND 

SETDLT 

SIGERR 

GDACK 

TSTMOD 

APSTAT 

HSTATS 

VHTHST 

VHATAC 

WKONCA 

ACSTAT 

SIGABT 

PRSTAT 

GDSTAT 


Test  Case 


All  Support  Test  AP's 
TSPUIMPU-Choice-3 
TSPUIMPU-Choioes-1 ,2 
All  Test  AP's 
All  Test  AP's 
TSPUIMPU-Choice-3 
TSPUIMPU-Cho ice-3 
TSGDMMPU 

Logic  Not  Implemented 

TSSIGMPU 

TSGDRMPU 

TSSUIMPU 

Logic  Not  Implemented 
Logic  Not  Implemented 
TSNTMMPU  Choice  8 
Logic  Not  Implemented 
Logic  Not  Implemented 
Logic  Not  Implemented 
Logic  Not  Implemented 
Logic  Not  Implemented 
Logic  Not  Implemented 


4. 1 .2.2 


4. 1 .2.3 


4. 1 .2.4 


Interface  to  Existing  AP's  TBD 


Interface  to  COMM  AP ' s 
(System  Services) 
INICOM 

Interface  to  UI 
(System  Services) 
INITEX 


Startup  (Start  COMVH) 


Run  TSPUIMPU , 
TSNTMMPU,  TSSERMPU  or 
TST12MPU 

LOGON  Run  TSPUIMPU . 
TSNTMMPU.  TSSERMPU  or 
TST12MPU  LOGOFF 
Run  TSPUIMPU, 

TSNTMMPU , 


Figure  5-1.  Requirement  to  Test  Matrix 


y« 
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4. 1.2. 5 


4. 1.3.1 


4. 1 .3.2 
4. 1 .3.2. 1 


4. 1 .3.2.2 


NTM  PS  Requirement 


CHGROL 


Interface  to  IISS  Operator 
(Operator  Commands) 

Start  IISS 
Start  APC 
Start  Link 
Shutdown  Host 
Shutdown  APC 
Shutdown  IISS 
Cancel  IISS  Shutdown 
Abort  AP 

Display  Active  AP's 
Display  IISS  Status 
Enable  Sigerr  Messages 
Disable  Sigerr  Messages 
Select  Logging  Features 
Start  Mew  Log  File 

Message  Header 

Monitor  IISS 

Accept  IISS  Operator 
Commands 

Service  Commands 
Start  IISS  on  VAX 
Start  IISS  on  Non-Vax 
Hosts 
Start  APC 
Start  Link 
Shutdown  APC 
Shutdown  IISS 
Shutdown  Host 
Cancel  IISS  Shutdown 
Abort  AP 

Display  Active  AP's 
Display  IISS  Status 
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Test  Case 

TSSERMPU  or  TST12MP0 
TSTNTMMPU-Cho i ce- 1 


Cat  Operator  Console) 
Run  Monitor 
Enter  "ST"  Command 
Enter  "SL"  Command 
Logic  Mot  Implemented 
Enter  "SC*  Command 
Enter  ”SD"  Command 
Enter  "CM”  Command 
Logic  Not  Implemented 
Enter  "DA"  Command 
Enter  "DS"  Command 
Enter  "SE"  Command 
Enter  "SO"  Command 
Enter  "LG"  Command 
Enter  "SM"  Command 


Enter  Commands  at 
Operator  Console 


Run  Monitor  (VAX) 

Run  Monitor  (HL6) 

Enter  "ST"  Command 
Enter  "SL"  Command 
Enter  "SC"  Command 
Enter  “SD"  Command 
Lcgic  Not  Implemented 
Enter  "CN"  Command 
Logic  Not  Implemented 
Enter  "DA"  Command 
Enter  “DS"  Command 


Figure  5-1.  Requirement  to  Test  Matrix  (Continued) 
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4 


DS 

Be* •  BTM  DS  Requirement  Test  Case 


4. 1.3.2. 3 


4. 1.3. 2. 4 


Deliver  IISS  Status 
Messages  to  Operator 

Aooept  Messages  Proa: 
IISS  APC's 
IISS  AP's 

Reaote  Monitor  AP'6 


All  Test  AP's, 
Startup,  Execute 
Operator  Coaaands 

Startup  IISS 
All  test  AP's 
Logic  Mot  Iapleaented 
on  Reaote  Host 


4. 1.3. 2. 5 


Send  IISS  Sy6tea  Coaaands 
and  Responses 

Operator  Abort 
Start  Link 

Canoe 1  Shutdown 

Start  MPU 

List  Request 
Shutdown  Link 
Shutdown  Pending 


Table  Status  Return 
Shutdown  Host 
Rebuild  Tables 


(at  Operator's 
Console) 

Logic  Not  Iapleaented 
Startup,  enter  "SL" 
Command 

Startup,  enter  “CN“ 
Coaaand 

Startup,  enter  “ST" 
Coaaand 

Enter  “DA"  Coaaand 
Enter  “LS“  Coaaand 
Enter  “SD"  Coaaand 
with  one  or 
aore  minutes  until 
shutdown 
Startup 

Logic  Hot  Iapleaented 
Logic  Hot  Iapleaented 


4. 1.3. 2. 6  Process  Messages 

Link  Active 
Link  Fail 

Processing  Error 
APC  Terminated 

Figure  5-1.  Requirement  to 


(Error  Message 
Displayed  at 
Operator's  Console) 
Startup,  Result  of 
“SL"  Command 
Startup,  REsult  of 
"LS“ 

Command,  Shutdown 
All 

Startup,  Shutdown. 
Result  of 
“SC"  Command 

Test  Matrix  (Continued) 
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DS 

Ref.  MTM  DS  Regal regent  Test  Case 


Logon 

Logoff 

Table  Status  Request 
Shutdown  Host 
APC  Alive 

Resouroe  Unavailable 


T8PUIMPU ,  TSMTMMPU. 
TSSERMPU . 

TST12MPU 

TSPUIMPU,  TSMTMMPU. 
TSSERMPU . 

TST12MP 

Startup  IISS 

Logic  Mot  Inplenented 

Startup  IISS.  “ST" 

Connand 

Upon  Receipt  of  “RU“ 
Message  fron  MPU 


Figure  5-1 .  Requirement  to  Test  Matrix  (Continued) 
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OS 

Ref. 


4. 1 .5.2.6 
(Coni . ) 


4.1 .3.2.7 


4. 1.3. 2. 8 


4.2.1 


4.2.2 


4.2.3 

4.2.4 


HTM  DS  Requirement 

AP  Interface  Error 

Tables  Rebuilt 
Timeout  Expired 


Send  1ISS  Status  Message 
Global  Table  Update 
Host  Available 
Host  Active 


OFF-Host  Shutting  Down 
APC  Shutting  Down 


Receive  and  Process 
Status  Messages  fron 
Renote  Monitor 

Receive  and  Interpret 
Message 


Authorize  Message 


Complete  Message  Header 
Logoff 

Perform  Special  Message 
Handl ing 
Paired  Messages 


Test  Case 

Upon  Receipt  of  "AI“ 
Message  from  MPU 
Logic  Mot  Implemented 
Upon  Receipt  of  *TE" 
Message  from  MPU 


Logic  Hot  Implemented 
Logic  Hot  Implemented 
Startup,  also  Upon 
Receipt  of  “LA" 
Message 

Upon  Receipt  of  "LF" 
Message 

Logic  Hot  Implmented 
Directly-  function 
handled  via  APC 
Status  Table  Update 


Startup ,  Execute 
Operator  Commands, 

All  Test  AP's 

Authority  Check  -  All 
Test  AP's  Authority 
Table -Table  not 
Populated 

All  Test  APs 
TSPUIMPU ,  TSNTMMPU , 


TSPUIMPU-Cho ice-3, 


Figure  5-1.  Requirement  to  Test  Matrix  (Continued) 
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HTM  DS  Requirement  Test  Case 

TSNTMMPU-Cho ice-4 , 
TSSERMPU-Choice  3  and 
5,  TST12MPU-cho ice-3 

QD  Messages  Logic  Mot  Implemented 

Specific  Initiation  TSPUIMPU-Cho ice-3. 

TSNTMMPU-Cho ice- 5 , 

Messages  TST12MPU-Choioe-3  and 

4 


4.2.5 

Log  Message 

Startup,  Execute 
Operator  Commands, 

All  Test  AP's 

4.2.6 

Route  and  Send 

Startup,  Shutdown, 

Message 

All  Test  AP's, 

Execute  Operator 
Commands 

4.2.7 

Interpret  Message 

Startup,  Shutdown, 

Category 

All  Test  AP's, 

Execute  Operator 
Commands 

4.2.8 

Initiate  AP 

TSPUIMPU-Choices-1-5 , 
TSNTMMPU-Cho ices -2 -5 

4.2.9 

Deliver  Messages  to  AP 

All  Test  AP's 

4.2.10 

Accept  Requests  from 

AP 

(System  Services) 

(AP's  Using  Services) 

GETUSR 

TSAP3MPU , TSAP4MPU , 
TSAP7MPU , TSAP8MPU , 
TSAP9MPU , TSAPDMPU 

INITAL 

All  Test  AP's  on  APC 
T1V 

TRMNAT 

All  Test  AP's 

ENDRCY 

Logic  Not  Implemented 
All  Test  AP's 

NSEND 

GDSEND 

TSGDMMPU 

I  SEND 

TSNTMMPU , TSPUIMPU , TSS 
ERMPU , TST 1 2MPU 

CHKMSG 

TSPUIMPU , TSNTMMPU , TSS 
ERMPU , TSAP8MPU , TST 1 2M 

Figure  5-1.  Requirement  to  Test  Matrix  (Continued) 
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DS 

Ref. 
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DS 

Ref. 


4.2.11 


4.2.12 


4.2.13 


4.2.14 


Figure  5 


NTH  DS  Requirement 


SETDLY 

GDACK 

MSGACK 

RCV 

TSTMOD 

CHGROL 

Terminate  AP 
Abort  AP 

Shutdown  AP  with  Logic 

AP  without  Logic 
Normal  Termination 


Handle  System  Commands 
Start  APC 

Shutdown  AP 


Shutdown  APC 
Display  Active  AP's 


Handle  APC  Message  Queues 
I'm  Alive  Queue 
Off -APC  Queue 
Initiation  Message  Queue 


Handle  APC  Tables 


Test  Case 

TSAP5MPU , TSAP6MP0 , 

PO 

Logic  Rot  Implemented 
Logic  Not  Implemented 
Logic  Not  Implemented 
All  Test  AP's 
TSSUIMPU 

TSNTMMPU -Cho 1 oe- 1 


Logic  Not  Implemented 
TSPUIMPU , TSNTMMPU , 
TSSERMPU 

TSAP 1MPU , TSAP9MPU 
All  Test  AP's  (via 
TRMNAT) 


Upon  Receipt  of  "ST" 
Command 

Direct  Command  Not 
Implemented  (AP 
Shutdown  only  as  the 
result  of  Shutdown 
APC  or  Shutdown 
IISS  Command) 

Upon  Receipt  of  "SC" 
Command 

Upon  Receipt  of  "DA" 
Command 


TSPUIMPU-Choices-1-3 
TSPUIMPU-Choice-1 . 
TSSERMPU-Cho ice-2 
TSNTMMPU-cho ice-2 

All  Test  AP's  require 
table  handling 


-1.  Requirement  to  Test  Matrix  (Continued) 
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Each  scenario  includes  specific  input  data  (some  of  which 
will  be  intentionally  wrong),  the  expected  processing,  and 
expected  output.  The  results  are  verified  by  'canned’  messages 
written  into  the  test  AP's.  The  NTH  Message  Log  and  I PC  ERRPRO 
will  be  used  to  provide  data  on  internal  processing.  A  third 
verification  tool  is  the  Monitor  AP's  capability  to  display 
error  messages  to  the  IXSS  Operator. 

5.2.2  Test  Plan 

The  testing  of  the  NTM  is  facilitated  by  a  primary  test 
driver,  TSPUI .  This  driver  was  designed  to  simulate  the  User 
Interface,  hence  it's  name  -  Pseudo  UI .  This  allows  user 
interaction,  error  and  status  displays,  and  testing  of  code 
specifically  designed  to  support  the  UI. 

TSPUI  gets  Logon  information  from  the  user  and  then 
presents  the  user  with  a  menu  of  choices  as  shown  in  Figure  5-2. 

$  RUN  TSPUIMPU 

ENTER  USER  NAME-MAXIMUM  OF  8  CHARACTERS. 

CROSS 

ENTER  ROLE  NAME-MAXIMUM  OF  10  CHARACTERS. 

TESTER 

(Date  and  Time  of  Logon) 

1  RUN  API 

2  RUN  AP2 

3  RUN  AP3 

4  RUN  TSPQS 

5  QUIT 

6  LOOP-3 

7  LOOP-1 

ENTER  CHOICE  NUMBER 


Figure  5-2.  TSPUIMPU  Menu 

The  user  enters  a  choice  thereby  setting  in  motion  a  specific 
test . 

TSPUIMPU  has  grown  too  large  to  incorporate  all  the  test 
choices  needed  to  exercise  the  NTM  code.  Four  more  test  drivers 
have  been  created  using  the  TSPUIMPU  "shell “  while  offering  new 
choices.  These  AP's  are  TSNTMMPU ,  TSSERMPU,  TST12MPU,  TSSUIMPU, 
and  TSGDMMPU.  Their  user  menus  are  shown  in  Figures  5-3  through 
5-8. 
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Fifteen  additional  test  AP's  have  been  written  to  support 
the  ohoioes  offered  in  the  test  drivers.  All  of  the  choices  are 
described  in  detail  in  the  next  section. 


$  R01I  TSRTMMPU 

EMTER  USER  MAKE-MAXIMUM  OF  8  CHARACTERS. 
CROSS 

EMTER  ROLE  MAME-MAXIMUM  OF  10  CHARACTERS. 
TESTER 

(Date  and  Tine  of  Logon) 


1 

2 

3 

4 

5 

6 

7 

8 


CHG  ROLE 
TEST  INIQ 
TEST  MI 
TEST  TO 
BAD  IMIT 
FILL  MBX 
WHTHST 
QUIT 


EMTER  CHOICE  HUMBER. 


Figure  5-3.  TSNTMMPU  Menu 


$RUM  TSSERMPU 

EMTER  USER  MAME-MAXIMUM  OF  8  CHARACTERS. 
CROSS 

EMTER  ROLE  MAME-MAXIMUM  OF  10  CHARACTERS 
TESTER 

(Date  and  Tine  of  Logon) 

1  INV  DEST 

2  OFF  APCQ 

3  CHECK  HOT 

4  FILL  LOG 

5  STUFF  MBX 

6  HOT  MBX 

7  QUIT 
ENTER  CHOICE  NUMBER. 


Figure  5-4.  TSSERMPU  Menu 
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$  RUM  TST12MPU 

ENTER  USER  NAME-MAXIMUM  OF  8  CHARACTERS. 

CROSS 

ENTER  ROLE  NAME-MAXIMUM  OF  10  CHARACTERS. 

TESTER  « 

(Date  and  Time  of  Logon) 

1  NO  MAILBOX 

2  FILL  CORE 

3  PAIR  INIT 

4  LONG  INIT 

5  RUN  QUEUE 

6  QUIT 
ENTER  CHOICE  NUMBER. 

6 

THE  TEST  APPLICATION  PROCESSES  PORTION  OF  THE  DEMO 
IS  COMPLETE 


Figure  5-5.  TST12MPU  Menu 
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$RUN  TSSOIMPO 

ENTER  USER  NAME-MAXIMUM  OF  8  CHARACTERS. 
CROSS 

ENTER  ROLE  NAME-MAXIMUM  OF  10  CHARACTERS. 
TESTER 

(Date  and  Tine  of  Logon) 


Figure  5-6.  TSSIG  Menu 


This  is  a  test  of  the  Sigerr  and  TSTMOD  services.  This  test 
invoices  a  test  AP  that  will  generate  a  requested  number  of 
nessages.  It  will  alternate  between  regular  messages  and  error 
nessages  of  different  severity  levels.  [Note:  The  logic  as 
described  here  works  but  does  not  necessarily  represent  the  full 
te6t  node  logic  which  was  only  partially  designed  and 
inplenented  in  Release  2.0. ] 

On  Choice  1  you  should  receive  the  indicated  number  of  regular 
messages  with  error  messages  of  alternating  severity  level. 

On  Choice  2,  you  should  receive  the  indicated  number  of  regular 
messages.  No  error  messages.  Informatory  (severity:  I) 
messages  will  also  be  displayed. 

On  Choice  3,  you  should  receive  the  regular  nessages  and  error 
messages  of  only  F  severity  level  and  informatory  (I)  messages. 

To  check  the  messages  that  are  being  sent  against  those 
received,  enable  the  Sigerr  messages  at  the  operator's  console 
(SE).  With  Sigerr  enabled,  all  SE  messages  will  be  displayed  at 
the  operator’s  console. 

1.  Set  TESTMODE  for  all  messages  and  test 

2.  Disable  testmode  for  no  error  messages  and 

test 

3.  Set  testmode  for  fatal  error  only  and  test 

4.  Quit. 


Figure  5-7.  TSSUIMPU  Menu 
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$Run  TSGDMMPU 

ENTER  USER  NAME-MAXIMUM  OF  8  CHARACTERS. 
CROSS 

ENTER  ROLE  NAME-MAXIMUM  OF  10  CHARACTERS. 
TESTER. 


This  is  a  test  of  the  guaranteed  delivery  service.  This  test 
invokes  a  test  AP  that  will  generate  a  guaranteed  delivery 
request  message  for  an  AP  that  will  process  this  request. 


MOTE:  Mo  formal  menu  will  appear.  If  the  GDSEND 
test  works, the  test  screen  will  display. 

GD  MESSAGE  IS  ON  ITS  WAY 

GD  AP  HAS  COMPLETED 

The  test  application  processes  portion  of  the  Demo 
is  complete 

Figure  5-8.  TSGDMMPU  Menu. 
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5.2.3  Test  Descriptions 

The  tests  needed  to  exercise  the  NTH  code  are  defined  below 
as  to  name ,  configuration,  description,  purpose,  and  AP 
Interface  services  tested.  The  overall  test  configuration  is 
shown  in  Figure  5-9. 


n 

Mira tor 
vtaola 


Itsapbmpu 


iJ-WJI.'.lilH 


MNV  ARC 

r - 


3 


imxnaii 


TSAP«MRU 


Kttivmpu 


-f  TSAPtMPU  1 
-(  TSAP7MPU  | 


iHTJTHIl 


H  TSAPWPul 


| NTMRVMPU 

P=1 

{  NTMONITV  | 


COM  ARC 


■  *t 
I 


j  |  NTCDMMPU  ]— L 

L  1 


1 


"tssic 


H 


TSPUIMPU^. 


j  iNTmvMPiTT— Htsntmmpu  h~t~ 
_____  L- 

TSSERMPU  h1  , 

-  Y 

T5T  12MPU  f  » 


I 
I 
I 

I 

I 

I 

I _ 


I 


_ J 

COV  ARC 


-iNTCOVMpTTlH  COMVHMPul 


I _ J 


Figure  5-9.  NTM  Test  Configuration 
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Test  Name:  Operator  Commands 
Test  Configuration: 


Test  Description: 

While  there  are  no  active  AP's,  the  operator  enters  each 
available  command  in  randon  order.  After  commands 
altering  the  system  state  (Shutdown  APC  and  Shutdown  Link) 
the  display  system  status  command  is  used  to  verify  the 
results . 

Test  Purpose: 

1.  Monitor  AP  System  Command  Processing. 

2.  MPU  System  Command  processing. 
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Test  Name:  Run  TSPUIMPU 
Test  Configuration: 


Console 


Test  Description: 

TSPOIMPU  connects  to  the  NTH  from  an  external  terminal 
logon  message  is  sent  to  Monitor  AP. 

Test  Purpose: 

1 .  Connect  to  NTH  from  external  terminal . 

2.  Send  a  message  from  an  AP  to  the  Monitor  AP. 

3.  Display  Logon  data  to  the  operator. 

4.  Logon  table. 

Services  Tested: 

INITEX 

LOGON 

System  Dependent  Code  Tested: 

SYSSASCTIM 
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Test  Name:  TSPUIMPU  -  Choice  1  or  2  ("Run  API"  and  "Run 
AP2" ) /TSPUIMPU -Choice-8( 1 oop-1) 

Test  Configuration: 


Test  Description: 

TSPUIMPU  starts  TSAP 1 MPU/TSAP2MPU  with  a  category  "B" 
message  (reply  required).  TSAP 1 MPU / TS AP2MPU  respond  and 
engage  in  a  limited  dialog  with  TSPUIMPU.  At  the  end  of 
the  dialog  TSAP 1 MPU/ TSAP2MPU  terminate  normally  while 
TSPUIMPU  waits  for  the  message  telling  it  that  a  child  AP 
has  ended  execution.  Choice-8  will  run  this  test  in  a 
continuous  loop  50  times. 

Test  Purpose: 

1.  Child  AP  Initiation. 

2.  AP  to  AP  communication. 

3.  Send  message  off-cluster. 

4.  Receive  message  from  off-cluster. 

5.  Send  Child  Termination  Message  to  Parent  AP. 

6.  Cleanup  upon  Child  Termination. 

7.  Send  Unsolicited  Initiation  Accept. 

8.  Log  Message. 

9.  Message  Pair  Table. 

10.  Choice-8  tests  the  NTM's  endurance  and  table 
handl ing . 

Services  Tested: 

INITAL 

NSEND 

RCV 

TRMNAT 
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Test  Name:  Late  Response  on  Message  Pair  (using  TSPUXMPU 
Choice-1) 

Test  Configuration: 


Startup  Startup  Shutdown  A  PC 


(to  T1V  MPU) 


Test  Description: 

Before  the  user  at  TSPUIMPU  enters  a  choice,  T1V  APC  is 
shutdown.  Then  the  user  enters  Choice  1.  TlV  APC  is  then 
started  but,  in  the  interin  the  aessage  to  TSAP1MP0  has 
timed  out.  TSAP1MPU  will  respond  anyway.  When  the 
response  gets  back  to  UIV  it  will  not  be  delivered  due  to 
the  timeout. 

Test  Purpose: 

1.  Message  Pair  Timeout. 

2.  Late  response  to  a  timed  out  message. 
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Test  Name:  TSPOIMPU  -  Choice  3  (‘Run  AP3" )/TSP0IKMP0 -Choice-7 
(Loop-3) 

Test  Configuration: 


Test  Description: 

TSPOIMPU  starts  TSAP3MPU  with  a  specific  initiation 
■essage.  TSAP3MPU  then  starts  TSAP4MPU.  TSAP3MPU  and 
TSAP4MPU  engage  in  a  lieited  dialog.  At  the  end  of  the 
dialog  TSAP3MPU  terminates  while  TSAP4MP0  continues 
execution.  TSAP4MPU  finds  the  original  source  AP 
(TSPOIMPU)  and  sends  it  a  final  status  sassage.  TSAP4MP0 
then  terainates . 

Choice-7  will  run  this  test  in  a  continuous  loop  50  tines. 
Test  Purpose: 

1.  Send  message  on-cluster. 

2.  Inaediate  Parent  dies  before  child. 

3.  Initiate  AP  on  category  "H*  message. 

4.  Cleanup  when  all  child  (and  grandchild)  AP's  are 

terninated. 

5.  Grandchild  AP  sends  message  to  Original  Source  AP. 

6.  In  choice-7  tests  endurance  of  the  MTM  and  Instance 

rollover  after  the  99th  Instance. 
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Services  Tested: 

I  SEND 
GETOSR 

CHKMSG  (Cold  Mailbox  -  Any  Match) 
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Test  Name:  TSPUIMPO  -  Choice  4  ("Run  TSPQS") 

Test  Configuration:  » 


Startup  Massaga 

TSPUIMPU 
(UIV  A  PC) 

AP-AP  Dialog 

Stop  Run  Maaaaga  ^ 

TSPQSMPU 
(TtV  APC ) 

4. 

Tar  ruination  Massaga 

- ► 

Table  Access 
Calls 


Assignment 

Table 


Test  Description: 

TSPUIMPU  starts  TSPQSMPU  (Pseudo  Queue-Server)  and 
displays  a  menu  of  Machinist  Numbers  and  Machinist  Names 
to  the  user.  The  user  enters  one  number  at  a  time  to  get 
the  group  assignment  of  the  machinist.  The  Queue-Server 
will  check  the  Assignment  Table  and  return  the  correct 
group  assignment  number.  This  test  will  run  until  the 
user  enters  ”99"  to  specifically  end  the  session. 

Test  Purpose: 

1 .  Queue  Server  Logic 
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Test  Name:  Shutdown  Pending /Shutdown  IISS  (using  TSPUIMPU  - 
Choice  4) 

Test  Configuration: 


Startup  Mas  saga 


Test  Description: 

While  running  Choice  4,  the  operator  enters  the  shutdown 
pending  command.  At  the  end  of  the  allotted  tine,  the 
shutdown  IISS  command  will  be  sent  to  the  active  APC's. 
The  user  on  TSPUIMPU  will  have  sufficient  time  to  end  the 
session  and  exit  gracefully.  Or,  the  user  can  continue 
the  session  until  TSPUIMPU  shuts  itself  down. 

Test  Purpose: 

1.  Monitor  and  MPU  Shutdown  Pending  Logic. 

2.  Shutdown  with  Active  AP's. 

3.  Soft  shutdown  of  AP  having  shutdown  logic. 

4.  Monitor  and  MPU  shutdown  IISS  logic 

Services  Tested: 

CHXMSG  (Hot  Mailbox  -  NTM  Requests) 
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Test  Name:  Shutdown  Pending /Cancel  Shutdown  (using  TSPOIMPU  - 
Choice  4) 

Test  Configuration: 


Assignment 

Table 


Test  Description: 

The  same  as  Shutdown  Pending /Shutdown  IISS  except  that  the 
operator  enters  the  cancel  shutdown  command  before  IISS 
shutdown  begins. 

Test  Purpose: 

1.  Monitor  AP  and  MPU  cancel  shutdown  logic. 

2.  Cancel  shutdown  message  to  the  01 . 
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Test  Haro:  TSPUIMPU  -  Choice  6  (Quit) 
Test  Configuration: 


Test  Description: 

TSPUIMPU  inf  ores  Monitor  AP  that  the  user  has  logged  off. 
It  then  disconnects  froe  the  MTM. 

Test  Purpose: 

1.  Disconnect  froe  the  MTM. 

2.  Logoff  Message  Logic. 

3.  Logon  Table. 

4.  Display  Logoff  information  to  the  Operator. 

Services  Tested: 

TRMNAT 

LOGOFF 
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Test  Maae:  TSNTMMPU  -  Choice  1  (Change  Role) 
Test  Configuration: 


Logon  Mossago 

TSNTMMPU 

Change  Role  Massage  ^ 

NTMONITV 
(MRV  A PC) 

(UIV  A  PC) 

Logoff  Message 

- » 

Logon  Mossago 


Now  Rota 


Logoff  Mossago  ^ 


Operator's 

Consota 


Test  Description: 

0 

The  user  logged  on  at  TSNTMMPU  is  allowed  to  change  the 
role  specified  at  Logon.  The  new  role  is  entered  and 
passed  to  the  Monitor  AP.  The  user  then  logs  off  using 
the  new  role. 

Test  Purpose: 

1.  Monitor  AP's  Change  Role  Logic. 

2.  Logon  Table  updates. 

Services  Tested: 

CHGROL 
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Test  Mane:  TSHTMMPU  -  Choice  2  (Test  Initiation  Queues) 
Test  Configuration: 

First  Initiation  Message  ^  ■■ 

Second  Initiation  Message  I 

- TT-T?  — - - — : - TTT^i  TSAP2MPU  01 

AP-AP  Dialog  (Instance  01)  |  ^T1V  ^pc  |_ 

s  Termination  Message 

AP-AP  Dialog  (Instance  02)  ^  ^  ' 

*  Termination  Message  |  TSAP2MPU02 


TSNTMMPU 
(UIV  A  PC) 


Test  Description: 

TSHTMMPU  sends  two  specific  initiation  Messages  to 
TSAP2MPU .  AS  TSAP2MPU  is  allowed  only  one  active  instance 
at  a  tine,  the  second  initiation  Message  is  queued.  When 
the  first  instance  terninates,  the  seoond  instance  is 
started. 

Test  Purpose: 

1.  Initiation  Message  Queue. 

2.  AP  Characteristic  of  single  instance. 

3.  Start  second  instance. 

4.  MPU  Tine  Check  Logic 
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Test  Name:  TSNTMMPU  -  Choice  3  (Test  Unsuccessful  Initiation) 
Test  Configuration: 


Test  Description: 

TSNTMMPU  attempts  to  start  "DUMMYMPU"  on  a  specific 
initiation  message.  "DUMMTMPU*  is  listed  in  all  the  right 
tables  but  does  not  in  fact  exist.  Upon  the  attempt  to 
start  it,  the  MPU  will  detect  that  it  is  not  alive  and 
return  an  Unsuccessful  Initiation  Message  to  the  source 
AP. 

Test  Purpose: 

1.  Unsuccessful  Initiation. 

2.  MPU  I'm  Alive  Table  Checker. 

3.  Child  Table  Logic. 
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Test  Name:  TSMTMMPU  -  Choice  4  (Test  Timeout) 
Test  Configuration: 


Test  Description: 

TSMTMMPU  attempts  to  start  "DUMMYMPU"  on  a  paired  message 
(non-specific  initiation).  The  startup  message  will 
timeout  and  the  UIV  MPU  will  return  a  timeout  expired 
message . 

Test  Purpose: 

1.  Message  Pair  Table 

2.  Pair  Timout  Checker 

3.  Timeout  Expired  Message 

Services  Tested: 

RCV  (Timeout -Expired) 
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Test  Name:  TSNTMMPU  -  Choice  5  (Bad  Initiation) 
Test  Configuration: 


Test  Description: 

TSNTMMPU  attempts  to  start  TSAP3MPU  on  a  non-specific 
initiation  message  (in  this  case,  category  “E”). 

TSAP3MPU ,  however,  has  the  characteristic  of  requiring  a 
specific  initiation  message.  An  error  message  will  be 
displayed  at  the  operator's  console.  The  source  AP  will 
also  be  informed  of  the  error  condition. 

Test  Purpose: 

1.  MPU  Logic  for  ‘’restricted”  AP's. 

Services  Tested 

TSTMOD 

SIGERR 
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Test  Haute:  TSNTMMPU  -  Choice  6  (Fill  Mailbox) 
Test  Configuration: 


Larae  Messaaes  J 

TSNTMMPU 

Large  Message  Responses 

TSAPAMPU 

(UIV  A PC) 

Termination  Request 

(T IV  APC) 

f  Termination  Message 

Test  Description: 

TSNTMMPU  sends  three  Messages  that  (a)  contain  the  maximum 
number  of  bytes  for  a  single  message  and  (b)  are 
sequentially  numbered .  TSAPAMPU  will  receive  the  messages 
and  respond  to  each  with  a  message  containing  the  number 
of  the  received  message.  TSAPAMPU  will  terminate  upon 
receipt  of  a  termination  request  from  TSNTMMPU « 

Test  Purpose: 

1.  Serial  message  queues. 
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Test  Name:  TSNTMMPU  -  Choice  7  (WHTHST) 
Test  Configuration: 


User  Imput 
Test  Description: 

TSNTMMPU  requests  an  AP  name  (with  directory  prefix)  from 
the  user.  TSNTMMPU  will  then  call  “WHTHST"  with  the  given 
AP  name.  The  WHTHST  return  will  be  displayed  to  the  user 

Test  Purpose: 

1 . 


WHTHST  Service. 
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Test  Name:  TSSERKPU-Choice-1  (Invalid  Destination) 
Test  Configuration: 


- » 

Message 
to  JUNK8MPU 


Test  Description: 

TSSERMPU  sends  a  message  to  " JUNKMPU"  which  has  neither 
existence  or  records  in  the  tables.  The  AP  will  receive 
the  "SEND- INVALID-DESTINATION"  return  on  the  "NSEND"  call. 
An  error  message  will  also  be  sent  to  the  monitor  AP.  (The 
error  message  will  be  displayed  on  the  operator's  console 
as  "31024-ACT"  entry  not  found  in  Authority  Check  Table). 

Test  Purpose: 

1.  MPU  message  management  logic. 

2 .  Send  returns . 

Service  Tested: 

NSEND  ( SEND- INVALID-DESTINATION ) 


TSSERMPU 
(UIV  A PC) 
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Test  Marne:  TSSERMPU-Cho ice-2  (Off  APC  Queue) 
Test  Configuration: 


Test  Description: 

This  is  no  longer  a  valid  test  because  a  change  in  the  NTH 
logic  in  Rel .  1.1  now  forces  messages  for  an  off -APC  that 
is  currently  not  available  to  be  rejected  rather  than 
queued  for  later  delivery  (only  guaranteed  delivery 
messages  will  be  queued  for  later  APC  delivery.)  A 
"Resource  Unavailable"  message  is  sent  to  APs  who  are  set 
to  receive  asynchronous  status  messages  from  the  HTM  on 
the  event  of  an  unavailable  APC  on  a  message  delivery 
request.  The  test  can  be  run  without  shutting  TIV  down 
but  it  does  not  test  anything  new.  The  test  AP  TSSERMPU, 
is  not  written  to  accept  or  display  the  Resource 
Unavailable  message. 
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Test  lase:  TSSERMPU-Cboice-5  (Check  Hot  Messages) 
Test  Configuration: 


Test  Description: 

Choice-4  enters  a  loop  that  repeatedly  checks  the  hot 
mailbox  for  a  message.  If  a  hot  message  is  found,  the 
type  is  interpreted  and  an  appropriate  display  is  shown. 
The  test  operator  should  enter  an  ”SD”  Command  at  the 
operator's  console  after  starting  this  test  and  respond 
with  a  time  greater  than  zero  on  the  "minutes  to 
shutdown?"  request.  The  te6t  AP  TSSERMPU  should  receive 
the  shutdown  pending  message  and  terminate.  The  IISS 
shutdown  should  proceed. 


Test  Purpose: 

1.  MPU  Shutdown  Pending  Logic 

2 .  MPU  Shutdown  where  an  AP  has  it's  own  Shutdown 
Logic. 

3.  Cancel  Shutdown  Logic. 

Service  Tested 

CKKMSG 

RCV 
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Test  Name:  TSSERMPU-Choice-4  (Fill  Log) 
Test  Configuration: 


Log  Table 
Entries 


Test  Description: 

TSSERMPU  calls  "LOGON"  15  times.  As  the  logon  table  has 
an  occurs  of  10,  at  least  five  of  the  entries  will  have  to 
be  written  to  a  file.  After  the  entries  are  written  they 
will  be  deleted  via  15  calls  to  "LOGOFF". 

Test  Purpose: 

1.  Table  File  Access  on  Write  and  Delete  Functions. 
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Test  Marne:  TSSERMPU-Choice-5  (Stuff  Mailbox) 
Test  Configuration: 


Blank  Messages 

TSSERMPU 

Request  Messaqes 

TSPASMPU 

(UIV  APC) 

^  Response  Messaqes 

(T1V  APC) 

Test  Description: 

TSSERMPU  sends  80  messages  to  TSPQSMPU  (Queue  Server) 
before  oalling  RCV .  As  TSPQSMPtJ  will  be  responding  to  the 
40  request  messages  long  before  TSSERMPU  calls  RCV.  the 
response  messages  will  have  to  be  queued  at  UIV  APC. 

Not i cable  delays  in  the  display  of  the  messages  sent  and 
received  will  occur  during  the  processing  of  this  test. 
This  is  because  of  the  timer  delays  that  occur  before  the 
queued  messages  are  processed. 


Test  Purpose: 


1 . 
2. 


AP  Queue  Handling. 
Buffer  Capacity. 
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Test  Naae:  TSSERMPU -Choice -6  (Hot  Mailbox) 
Test  Configuration: 


Start  Message 

TSSERMPU 

Error  Messaqe 

TSAP2MPU 

(UIV  APC) 

Termination  Messaqe 

(T1V  APC) 

Test  Description: 

TSSERMPU  sends  a  Message  to  TSAP2MPU  that  will  cause 
TSAP2MPU  to  call  RCV  for  a  ahota  Message.  As  TSAP2MPD 
does  not  support  a  "hot"  Mailbox,  it  will  receive  an  error 
return.  This  return  will  be  sent  to  TSSERMPU  in  a  Message 
froM  TSAP2MPU .  TSAP2MPU  will  then  terninate  itself. 

Test  Purpose: 

1.  AP  Characteristic  of  Kuaber  of  Mailboxes  Supported. 

2.  RCV  handling  of  an  invalid  call. 
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Test  Vase:  TST12MPU-Choice-l  (Mo  Mailbox) 
Test  Configuration: 


Start  Maasaqe 

TST12MPU 
(UIV  APC) 

Test  Message 

TSAPBMPU 

Termination  Message 

(T1V  APC) 

Test  Description: 

TST12MPU  starts  TSAPBMPU.  TSAPBMPU  has  the  characteristic 
of  having  no  mailboxes.  Then  TST12MPU  sends  a  message  to 
TSAPBMPU,  an  error  message  will  come  back.  TSAPBMPU  will 
terminate  itself. 

Test  Purpose: 

1.  -Mo  Mailbox”  logic  in  IHITAL,  RCV,  and  MPU. 
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Test  Mane:  TST12MPU-Cho ice-2  (Fill  Core) 
Test  Configuration: 


Count 

Test  Description: 

TST12MPU  sends  a  series  of  specific  initiation  Messages  to 
TSAPCMPU  in  order  to  fill  the  in-core  dynamic  tables. 
TSAPCMPU  will  start,  call  RCV,  and  terninate.  TST12MP0 
will  receive  AP  Ending  Messages  equal  to  the  number  of 
initiation  Messages  sent. 

Test  Purpose: 

1.  Fill  in-core  tables  in  order  to  test  table  handling 
when  writing  to  a  file. 
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Test  Name:  TST12MPU-Cho ice-3  (Paired  Initiation) 
Test  Configuration: 


Paired  Initiation  Message 

TST12MPU 

Paired  Reponse 

TSAPDMPU 

(UIV  APC) 

Termination  Messaqe 

(T1V  APC) 

Test  Description: 

TST12MPU  sends  a  paired  initiation  message  to  TSAPDMPU.  A 
new  instance  of  TSAPDMPU  will  be  started  and  it  will 
respond  to  the  message.  TSAPDMPU  will  then  terminate 
itself. 

Test  Purpose: 

1.  I SEND  logic  for  sending  paired  messages. 

2.  MPU  logic  to  handle  category  " J*  messages. 
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Test  Name:  TST12MPU -Choice -4  (Long  Initiation) 
Test  Configuration: 


Continued  Initiation  Msg. 

TST12MPU 

^Size  of  Received  Message 

TSAPDMPU 

(UIV  APC) 

t  Termination  Message 

(T1V  APC) 

Test  Description: 

TST12MPU  sends  a  continued  initiation  message  to  TSAPDMPU. 
A  new  instance  of  TSPDMPU  will  be  started.  It  will  call 
RCV  and  return  the  number  of  bytes  of  data  received  in  a 
message  to  TST12MP0 .  TSAPDMPU  will  then  terminate  Itself. 

Test  Purpose: 


1. 


I SEND  logic  for  sending  continued  messages. 
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Test  Rue:  TST12MPU  -  Choice  5  (Run  Queue) 
»  Test  Configuration: 


Test  Description: 

TST12MPU  starts  TSAP5MPU ,  TSAP6MPU ,  and  TSAP7MP0 .  Each  AP 
begins  sending  a  series  of  three  aes sages  to  the  Queue 
Server  (TSPQSMPU).  TST12MPU  also  sends  a  aes sage.  creating 
the  situation  where  four  AP's  are  coaaunicating  with  the 
saae  instance  of  the  queue  server.  At  the  end  of  the 
dialog.  TSAP5MPU ,  TSAP6MPU ,  and  TSAP7MPU  inf ora  TST12MP0 
that  they  are  finished.  When  TST12MPU  has  heard  froa  all 
the  AP's  it  tells  TSPQSMPU  to  shutdown. 
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This  test  was  at  one  time  driven  by  TSPUIMPU.  Due  to  the 
handling  of  a  Queue  Server  as  a  "child''  of  the  MTM,  the 
source  AP  has  no  way  of  knowing  when  a  Queue  server  has 
terminated.  The  source  will  continue  to  send  messages  to 
a  (possibly)  dead  AP.  This  test  was  moved  to  avoid  this 
occurrence . 


Test  Purpose: 

1.  Multiple  Parents  per  instance. 

2.  Message  Queues. 

3.  Delivery  of  messages  to  a  Queue  Server  Type  AP. 

Services  Tested: 

RCV  (Message  Buffer  Logic) 

NSEND 

GETUSR 


DS  620142000 
1  November  1985 


Test  Naae:  Shutdown  APC  with  Active  AP's  (using 
TST 1 2MP0 -Cho i ce - 5 ) 


Test  Configuration: 


Test  Description: 

There  are  two  variations  on  this  test. 

1.  The  user  enters  Choice  5  followed  iaaediately  by 
the  Operator  entering  the  Shutdown  APC  Coaaand 
(T1V).  In  this  case,  soae  of  the  AP's  on  T1V  will 
be  in  the  initiation  stage.  A  message  is  sent  to 
Monitor  to  that  effect. 

2.  The  user  enters  Choice  5.  The  Operator  waits  until 
all  the  AP's  are  active  and  then  enters  the 
Shutdown  APC  Coaaand.  As  none  of  the  AP's  have 
shutdown  logic,  they  will  be  aborted  and  the  APC 
terninated  message  is  sent  to  Monitor. 
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Test  Purpose: 

1.  A PC  Shutdown  Logic  with  AP's  still  in  initiation 
phase . 

2.  A PC  Shutdown  Logic  with  active  AP's  on  cluster. 
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Test  Mane:  TSSDIMPU  -  Choice  1.2.3 
Test  Configuration: 


call 

TO 

SCT 


Start  MSC  That  Contains  Tha  Nustbsr  g 

TSSUIMPU 

Of  Raquwatad  Mmmqm 

1  Rnulv  MMUMl-Ctntrilid  with  NSSNDf 

TSSIGMPU 

furv  apc) 

/  • 

Error  Mtmgti  •  Conoratod  with 

(TlV  MPU) 

( 

9  Sigwrr  Call** 

TSTMOD  SERVICE 

r"  Tarwinat  on  Mataaoa 

•Sigerr  generated  nessages  are  also  directed  to  the 
■onitor.  and  can  be  displayed  by  entering  "SE"  at  the 
operator's  console.  The  default  at  IISS  startup  is  for  no 
logging  of  Sigerr  generated  Messages  at  the  operator's 
console. 


Test  Description: 

TSSUIMPU  tests  the  three  user  testnodes  that  are  setable  by 
oalls  to  TSTMOD  in  the  three  TSSUIMPU  test  choices.  On  Choice 
1.  TSTMOD  is  called  to  request  the  receipt  of  all  nessages  by 
the  test  program.  It  also  requests  the  tester  to  enter  a  number 
that  will  tell  the  test  program,  TSSIGMPU,  the  number  of 
messages  to  generate  in  this  test.  On  its  startup,  TSSIGMPU  in 
all  of  the  choices  will  loop  through  a  series  of  reqular 
messages  sends,  then  Sigerr  generated  messages  of  severity 
levels  (I,  inform&tory;  V,  warning;  F.  fatal).  On  Choice-1,  the 
test  screen  should  display  the  received  list  of  messages  and 
their  types.  This  list  should  contain  a  cycle  of  a  regular 
message  followed  by  error  messages  of  Severity  I.  V,  and  F. 

On  Choice  2,  TSTMOD  is  called  to  request  that  no  error 
messages  be  sent  to  the  user  Screen.  Again,  the  tester  must 
supply  the  number  of  messages  of  each  class  that  TSSIGMPU  should 
generate.  TSSIGMPU  cycles  through  its  message  series  in  the 
same  manner  as  in  Choice-1,  but  in  this  test  the  only  messages 
that  are  displayed  are  the  regular  messages  and  the  I 
( Inf ormatory )  messages  generated  by  TSSIGMPU  calls  to  Sigerr.  A 
verification  that  TSSIGMPU  is  generating  all  classes  of  Sigerr 
messages  can  be  made  by  enabling  SE  at  the  operator's  console 
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and  naking  sure  that  error  Messages  of  all  types  have  been 
received  at  the  operator's  console  during  the  test. 

On  Choice  -3,  TSTHOD  is  called  to  request  that  the  only 
Sigerr  generated  error  Messages  it  should  receive  are  the  fatal 
(FI  error  Messages.  The  test  proceeds  as  in  the  other  choices, 
but  in  this  oase  only  regular,  Inforaatory  (I),  and  fatal  (F) 
error  Messages  will  be  displayed  on  the  test  console. 

Test  Purpose: 

1.  TSMOD  Service  Test. 

2.  Sigerr  Service  Test. 

3.  "SE"  Operator's  coaaand  test 

4.  Mew  RCV  logic  to  support  filtering  necessary  with 
the  TSTHOD  flag. 
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Test  Haae:  TSGDMMPU  -Test  Guaranteed  Delivery  Service. 

Test  Configuration: 


(D 

TSCDMMPU 

Category  "A" 

NTUIVMPU 

(UIV  ARC) 

Guaranteed  Delivery  * 
(CO)  Meeaage 

TSGDRMPU 
IT1V  ARC) 


(2) 


(51 


t«) 

CD  Message 

-e 

It") 

"GA"  Tvoe  -  User 

■nr 

CO  ACK 

z 

"I *•  Dying"  Message 


(GD, 

i 

a 

"GX" 

"GY"  Type 

Message 

Type 

NTM-ACK  BACK 

NTM-ACK 

Message  for  CO 

Message  for 

Message 

! _ 

GD  Mess  see1 

L 

1 

NTTIVMPU 


(») 


"CA" 

Mtlliq* 


Test  Description: 

TSGDHMPU  tests  the  HTM's  guaranteed  delivery  logic,  the 
two  services,  GDSEHD  and  GDACK.  On  the  startup  of  TSGDHMPU,  a 
guaranteed  delivery  (GD)  Message  is  requested  with  the  service, 
GDSEHD.  A  Message  of  category  "A"  (GD)  is  generated  for 
TSGDRMPU.  After  it  has  been  accepted  (logged)  by  HTUIVMPU,  a 
Message  "GD  Message  Aocepted"  should  appear  on  the  test  screen. 
The  rest  of  the  test  needs  to  be  verified  by  checking  the 
MTMLOG. 

If  the  test  worked  correctly,  after  NTTIVMPU  receives  the 
"A*  category  Message  from  TSGDHMPU,  it  should  send  an  MTM-GD 
acknowledgment  to  HTUIVMPU  (Message  type:  "GX”).  HTUIVMPU 
should  then  send  an  NTM-GD  AckBack  Message  (Message  type:  "GT") 
to  NTTIVMPU.  On  its  receipt  of  the  GD  Message,  TSGDRMPU  should 
send,  via  GDACK,  a  user  GD  acknovledgeaent ,  Message  type  "GA” , 
before  terainating. 

Test  Purpose: 

1.  Test  GDSEND  Service. 

2.  Test  GDACK  Service. 
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5.  Test  MPU  handling  of  GD  Messages. 

5.2.4  Formal  Qualification  Tests 

Formal  Qualification  testing  will  be  designed  and  performed 
by  General  Sleetrlo  with  support  fron  SofTech. 
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SBCTIOB  6 

PREPARATION  FOR  DELIVERY 


The  software  associated  with  this  MTM  CPGI  release  will  be 
delivered  on  a  aedia  which  is  ooapatible  with  the  II8S  Test  Bed. 
The  release  will  be  dearly  identified  as  to  release,  date, 
content,  foraat  and  function  and  will  include  instructions  on 
procedures  to  be  followed  for  installation  of  the  release. 
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APPENDIX  A 

TERMS  AMD  ABBREVIATXOMS 


The  following  is  a  list  of  synbols,  abbreviations,  and 
aoronyns  used  throughout  this  developaent  specification. 

LIST  OF  SYMBOLS ■  ABBREVIAT10MS ,  ACROMTMS 

AP  Application  Prooess 

A PC  Application  Process  Cluster 

API  Application  Prooess  Interface 

CDHRP  Cosaon  Data  Model  Request  Processor 

COMM  Connuni oat ions  Handler 

CPC I  Coaputer  Prograa  Configuration  I tea 

DBMS  Data  Base  Manageaent  Systea 

DHL  Data  Manipulation  Language 

I CAM  Integrated  Coaputer  Aided  Manufacturing 

IDSS  Integrated  Decision  Support  Systea 

IISS  Integrated  Inforaation  Support  Systea 

I PC  Inter  Prooess  Coaaun i cat i on 

LAN  Local  Area  Network 

MCMM  Manufacturing  Control  Material  Manageaent 

MDL  Message  Definition  Language 

MM  Message  Manager 

MO  Maintain  Operability 

MPU  Message  Processing  Unit 

MRP  Materials  Requireaents  Planning 

MSG  Message 

NTM  Network  Transaction  Manager 

OS  Operating  Systea 

PM  Process  Manager 

QA  Quality  Assurance 

SS  Systea  Specification 

UI  User  Interface 

VAX  Tradeaark  of  Digital  Equipaent  Corporation:  32 

bit  ainicoaputer 

Tradeaark  of  Digital  Equipaent  Corporation:  The 
VAX  OS 


VMS 
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This  paragraph  contains  definitions  of  IISS  related  terns 
and  general  oonputer  terns  that  are  used  in  this  docunent.  In 
addition,  it  oontains  definitions  for  seleoted  terns  used  in  the 
IDEFO  Model  (Appendix  B)  and  serves  in  lien  of  a  fornal  nodel 
glossary. 


AP 

Abnornal 

Ternination 
Alive  AP 

Appl i cat ion 
Process 


Application 
Process  Cluster 


Authorization 


See  Application  Prooess. 

Stoppage  of  a  process  prior  to  its  nornal 
oonpletion. 

(Abort) 

An  application  prooess  that  is  capable  of 
being  initiated. 

Within  the  IISS  Architecture;  a  oohesive 
unit  of  software  that  can  be  initiated  as  a 
unit  to  perforn  sone  function  or  functions. 
See  also:  Process. 

A  logically  related  group  of  application 
processed  that  resides  on  a  single  host 
systen.  The  application  processes  are 
collected  at  a  single  cluster  because  of 
their  common  need  to  access  the  same 
database.  (In  previous  MTM  documents  this 
concept  was  referred  to  as  "Workstation" ) . 

A  relationship  between  message  type  a 
legal  paths  of  messages  conforming  to  that 
type. 


Awake  AP 


An  application  process  that  is  currently 
executing. 
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Backlog 

CDMRP 
COMM 
CPC  I 

Clean  Point 

Cluster 
Common  Data 

Coauaon  Data  Model 
CCDM) 


Messages  waiting,  in  a  queue,  to  be 
processed. 

See  Common  Data  Model  Request  Processor. 

See  Communications  Handler. 

Computer  Program  Configuration  Item.  A 
oohesive  testable  (stand-alone)  system  with 
well-defined  external  interfaces. 

A  baseline  of  the  entire  system  Btate  at  a 
given  point  in  time  so  that  recovery  is 
possible  from  that  point. 

See  Application  Prooess  Cluster. 

Information  that  may  be  shared  among  users 
and  is  subject  to  policies  and  procedures 
of  the  IISS. 

A  description  of  the  data,  its  structure, 
allowable  operations,  and  integrity 
constraints  for  data  of  oommon  interest 
within  the  IISS. 


Common  Data  Model  The  implementation  of  the  CDM  within  the 
Request  Processor  IISS.  The  ourrent  design  specifies  the  use 

of  extremities. 


Commun i cat ions 
Handler 


DBMS 


An  IISS  Configuration  Item  that  services 
IISS  network  communications.  It  accepts 
messages  from  the  NTM  for  off-host 
destinations.  It  provides  NTM  with 
messages  from  off-host  sources. 

See  Data  Base  Management  System. 


DML 

Database 


Data  Base 
Management  System 


See  Data  Manipulation  Language. 

A  collection  of  logically  related  data 
managed  by  a  DBMS. 

A  computerised  system  consisting  of 
numerous  components,  which  have  as  their 
collective  purpose  the  implementation, 
management,  and  protection  of  large-scale 
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data  bases. 

Data  Manipulation  A  formal  language  for  specifying  data 

Language  modification,  and  retrieval  functions  under 

a  DBMS . 

Destination  An  application  process  (which  may  be  user 

role;  to  which  a  message  is  sent. 

Heterogeneous  Composed  of  parts  of  different  kinds; 

having  widely  dissimilar  elements  or 
constituents . 

Homogeneous  Composed  of  parts  all  of  the  6&me  kind. 

Host  See  Host  Machine. 

Host  Machine  A  configuration  of  a  processor(s)  and 

associated  peripherals. 

IISS  Component  Application  Processes  involved  in  IISS 

support  activities.  See:  CDMRP ,  UI,  COMM. 

IISS  Operation  Messages  entered  directly  to  the  NTM  by  an 

operator . 

Messages  These  include:  startup,  shutdown,  restart, 

and  provide  status  and  statistics. 

IISS  Shutdown  A  signal  or  IISS  operator  command  that 

initiates  the  orderly  shutdown  of  the 
entire  IISS  system  or  an  individual 
workstation . 

IISS  Startup  A  signal  or  IISS  operator  command  that 

initiates  the  IISS  on  a  single  host. 

Integrated  AP  An  application  process  designed  and  written 

in  accordance  with  the  IISS  Integration 
rules . 

Initiation  Message  A  message  that  specifically  requires  the 

initiation  of  an  application  process.  The 
message  may  also  carry  data  for  that 
process . 


LAN 


Local  Area  Network. 
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Load 

MDL 

MM 

Maintain 

Operability 

Message 

Message  and  Error 
Log 

Message  Category 

Messages  fron 
Off-Cluster 


Message  fron 
On-Cluster 


Message, 

Definition 


Message  Manager 


To  bring  a  bound  (linked)  set  of  oonputer 
instructions  into  a  oonputer  nenory  unit  in 
preparation  for  its  execution  as  a  process. 

Message  Definition  Language.  Neutral  syntax 
and  seaantios  for  formatting  IISS  messages. 

See  Message  Manager. 

The  name  given  to  that  part  of  the  NTM  that 
will 

Facilitate  system  wide  services  of  restart, 
recovery,  shutdown,  and  system  status 
monitoring  and  recording. 

A  structured  unit  of  information. 

The  record  of  messages  (legal  and 
erroneous)  that  are  processed  by  the 
message  manager. 

A  group  of  message  types  sharing  common 
processing  requirements. 

Any  message  that  has  as  its  source  an  AP  or 
NTM  that  is  not  resident  on  the  cluster  in 
question. 

Any  message  sent  by  a  local  AP  that  is 
directed  to  another  on  APC  AP  or  to  another 
NTM  (i.e.,  requiring  the  routing  services 
of  the  Message  Manager). 

The  legal  (reoognized  and  allowed)  values 
to  which  a  message  must  conform  to  be 
accepted  for  processing  at  an  AP  on  a  given 
APC  on  a  given  host.  The  values  are 
contained  in  tables  which  are  defined  in 
Section  3.5.3 

The  name  given  to  the  part  of  the  NTM  that 
will  provide  the  service  for  the  identified 
Manage  Message  functions  (see  DS/A1  Section 
10.2). 
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Message  to  IISS 
Operator 


Messages  to 
Off -Cluster 


Message  to 
On-Cluster 

Message  to  be 
Routed 

Message  Type 
MO 

MO  Data  and  Status 
Messages 

Native  Mode 

Network 

Non- integrated  AP 
NTM 

OS 

OS  Process  Control 
Response 

OS  Process  Control 
Request 


Typically  a  response  to  an  operation 
request.  This  message  oould  also  be  a 
request  for  operator  action. 

Any  message  that  has  as  its  souroe  an  AP  or 
NTM  that  is  not  resident  on  the  cluster  in 
question. 

Messages  directed  to  an  AP  (resident  on  the 
cluster)  that  contain  information  necessary 
for  the  process  to  perform. 

A  message  that  has  another  AP  as  its 
destination. 

The  identification  of  the  nature  of  a  given 
message. 

See  Maintain  Operability. 

Any  message  directed  to  the  maintain 
operability  function. 

Character  code  native  to  a  particular 
machine,  either  ASCII  or  EBCDIC. 

Several  computers  and  a  communications 
facility  connecting  them. 

An  Application  Process  designed  without 
adherence  to  the  IISS  Integration  rules. 

Network  Transaction  Manager.  That  portion 
of  the  IISS  that  manages  messages  and 
application  processes  and  maintains  the 
operability  of  the  IISS. 

See  Operating  System. 

Response  from  the  host  operating  system  to 
a  request  for  services,  (i.e.,  process  ID 
assigned,  process  exists,  process  does  not 
exist) . 

Request  for  services  to  be  provided  by 
the  host  operating  system. 
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On-APC  AP  Messages 

Operability 

Messages 

Operating  System 

Priority 

Prooess 

Process  Manager 

Process  Name 

Requirement 

Resources 

Source 

Status  and 
Statistics  Log 

System 


( 

i 

Any  message  that  has  as  its  destination  an  i 

AP  that  is  resident  on  the  workstation  in 
question.  ! 

Messages  initiated  by  maintain  operability 
to  handle  an  IISS  operation  request  and  to 
monitor  the  IISS  system. 

i 

Software  that  controls  the  execution  of  I 

computer  programs  and  that  may  provide  I 

scheduling,  debugging,  input-output 

control,  accounting,  compilation,  storage  ' 

assignment,  data  management,  and  related  ! 

overal 1  system  management . 

The  expectation  of  processing  urgency  | 

assigned  to  a  message  type.  The  recognized 
transaction  priorities  are:  standard, 
immediate  and  time-triggered. 

The  basic  unit  of  work  from  the  standpoint 
of  the  computer's  operating  system. 

The  name  given  to  the  part  of  the  NTM  that 
will  provide  the  service  for  the  identified 
Manage  Processes  function.  (See  DS/A2, 

Section  10.2) 

The  AP  Name  and  instance  identifier  of  an 
initiated  AP. 

Stated  functions  for  information  processing 
and  associated  constraints. 

People,  hardware,  software,  and  other 
components  used  to  process  information. 

An  Application  Process  from  which  a  message 
is  sent. 

Data  regarding  the  AP  status,  resource 
utilization,  message  traffic  provided  in 
response  to  an  operation  request. 

A  collection  of  people,  hardware,  software 
and  methods  organized  to  accomplish  a  set 
of  specific  functions. 
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Task 

Test  Bed 

UI 

Update 

User 

i 

i 

i 

User  Application 
Process 

User  Interface 

View 

Workstation 


See  Process. 


A  collection  of  ooaputer  hardware, 
software,  storage  devices,  and  other 
peripherals  used  for  testing  application 
software  and  system  concepts.  Usually  not 
the  target  operational  6ystea. 

See  User  Interface. 

The  process  of  changing  values  in  all  or 
selected  entries,  groups,  or  data  iteas 
stored  in  a  database  or  adding  or  deleting 
data  occurrences . 

Human  being  who  requests  processing  to  be 
done.  The  person  entering  a  transaction  at 
a  terainal .  The  user  can  also  be  a 
non-human  that  performs  these  functions  but 
this  tera  will  not  be  used  in  this  sense  in 
this  specification. 

Any  application  process  not  involved  in 
IISS  support 

An  application  process  that  manages  the 
user-terminal  interface. 

That  which  is  within  the  range  of  vision. 
Also,  that  data  which  is  of  interest  to  a 
specific  application  process. 

See  Application  Process  Cluster 
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APPENDIX  B 


B.l  IDEFO  Model  of  the  NTH 

The  model  presented  here  represents  conceptual  view  of  the 
II8S  and  the  workstation  environment  in  which  the  NTH  will 
operate  (ENV/A-1)  along  with  the  functional  breakdown  of  the  NTH 
components .  The  description  of  the  functional  processing  shown 
in  the  model  is  found  in  Section  4.2  and  serves  in  lieu  of  text. 
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NTM  ENVIRONMENT  ON  Ul  ARC 


OAT: 
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NTM  ENVIRONMENT  ON  COMM  IS 


Messago  Definition 
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ENV/A-1  F2  NTM  ENVIRONMENT  ON  COMM  APC 
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TITLE: 

ENV/A-IF3  NTM  ENVIRONMENT  ON  MONITOR  WORKSTATION 
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OPERATE  NTM 
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TITLE: 

DS/A1  MANACE  MESSACE 
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APPEMDIX  C 


C.l  1DEF1  Model  of  the  WTM 

The  Model  presented  here  represents  the  structure  of  the 
data  required  to  perforn  the  WTM  functions.  The  data  iteas 
identified  in  the  nodel  are  defined  in  Appendix  D  (in  lieu  of  a 
formal  glossary).  The  table  usage  and  structure  is  defined  in 
Section  4.5.3. 
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CONTEXT: 
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LINK 
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QUEUE 
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AUTHORITY 


CONTI  XT: 
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MHO  Of  BACKLOG 


TERMINAL 
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LOC  ON 
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OAI 
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TYPE  OF  ELEMENT 
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MESSACE  CATECORY 


fo  AT  (AUTHOR  Softech  OATS:  2/I/I3  |  Ijgjjgjjjff  (REAPER  QATg] CONTIXT: 


NOOE  TITLE 

EHO  authority 
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E*i  LOGICAL  HOST 
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MAILBOX 


IO  At 


EM 


MSG  SERIAL  ».  (SOURCE)  AP 
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E22E 


CHII.O 
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QUEUE  SERVER 
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APPENDIX  D 

DATA  ITEM  DESCRIPTIONS 


Each  data  item  required  by  the  NTH  is  defined  below.  The 
items  are  presented  in  alphabetical  order  for  easy  reference. 
The  data  items  used  by  the  AP  interface  servioes  are  described 
In  the  System  Servioes  Manual  [8]. 
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Data  I tea  gage;  Access  Flag 


Data  I tea  ID:  ACCFLG 


Data  I tea  Description: 

Identifies  whether  the  access  to  a  given  AP  is  restricted 
or  open.  This  applies  only  to  aessages  belonging  to 
categories  defined  as  requiring  authorisation. 


Data  I tea  Picture:  X 
Coding  Type:  Alpha/Nuaeric 
Data  I tea  Stability:  Static 


Sise  in  Bytes :  1 

IDEF1  X  Ref. :  N/A 

Legal  Value  Set  By: 
AP  Developer 


Where  Used:  Authority  Check  Table 


Value 

Legal  Values _ Representat  1  on 


Value  Definition 


Restricted 


0 


Open 


1 


Ap  has  restricted 
Access  -  requires  an 
authority  check 

AP  has  open  access  - 
no  authority 
required 


D-2 
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Data  Item  Haute:  ACK  to  Source  MPO  Data  I tea  ID:  MPUACK 


Data  I tea  Description: 

Identifies  whether  the  aessage  causing  the  initiation  of 
an  AP  conforas  to  category  E  (unsolicited  aessage).  Where 
the  initiation  aessage  is  category  E,  the  destination  MPU 
will  return  an  unsolicited  Initiation  Aooept  (aessage  type 
IA)  to  the  souroe  MPU. 

Data  I tea  Picture:  X  Sise  in  Bytes :  1 

Coding  Type:  Alpha/Nuaeric  IDEF1  X  Ref . :  N/A 

Data  I tea  Stability:  Dynaaic  Legal  Value  Set  By: 

Message  Category 


Where  Used:  I 'a  Alive  Table 

Value 

Legal  Values _ Representat i on _ Value  Definition 


No  Send  ACK 


0 


No  ACK  required  on 
initiation 


Send-ACK 


1 


ACK  required  on 
initiation 
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Data  Item  Name:  AP  Cluster  "Cold”  Mailbox  Data  Item  ID:  APCCMB 
Data  Item  Description: 

The  name  of  the  mailbox  used  for  low  priority  messages 
coming  into  the  AP  Cluster.  The  messages  may  either  be  from 
a  resident  AP  or  from  another  cluster. 

The  priority  level  is  determined  by  the  message  category 
and  is  relative  to  the  NTH .  The  priority  under 
consideration  in  this  case  haB  no  bearing  on  the  priority 
of  an  Application  Process. 

Data  Item  Picture:  X(14) 

Coding  Type:  Alpha/Mumeric 
Data  Item  Stabi 1 i ty:  Dynamic* 


Size  in  Bytes :  14 
IDEF1  XRef :  EC  2 
Legal  Value  Set  By: 
Derivation  from  APC 
Name 


Where  Used:  APC  Startup 

Value 

Legal  Values _ Representat i on _ Value  Definition 


Mon-VAX-C-MBX 

Mon-IBM-C-MBX 

Mon-HL6-C-MBX 

User-Int-C-MBX 

COMM-VAX-C-MBX 

COMM- IBM -C-MBX 

C0MM-HL6-C-MBX 

CDM-C-MBX 


MR VCbbbbbbbbbb *  * 
MR I Cbbbbbbbbbb 
MRHCbbbbbbbbbb 
U I VCbbbbbbbbbb 
COVCbbbbbbbbbb 
CO I Cbbbbbbbbbb 
COHCbbbbbbbbbb 
CDMCbbbbbbbbbb 


VAX  Monitor  APC  Cold 
Mai lbox 

IBM  Monitor  APC  Cold 
Mai lbox 

HL6  Monitor  APC  Cold 
Mai lbox 

User  Interface  Cold 
Mai lbox 

VAX  COMM  APC  Cold 
Mailbox 

IBM  COMM  APC  Cold 
Mai lbox 

KL6  COMM  APC  Cold 
Mai lbox 

CDM  APC  Cold  Mailbox 


*In  all  cases,  the  distinction  between  static  and  dynamic  data 
is  based  on  whether  the  data  is  obtained  from  the  CDM,  or 
generated  within  the  NTM.  Therefore,  data  obtained  from  the  CDM 
is  static.  All  other  items  are  dynamic. 

**Note:  the  last  byte  in  the  mailbox  name  is  reserved  for 

non -NTM  use. 
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Data  I tea  Haae:  AP  Cluster  "Hot"  Mailbox  Data  I tea  ID:  APCHMB 


Data  I tea  Description: 

The  naae  of  the  aailbox  used  for  high  priority  aessages 
coaing  into  the  AP  Cluster.  The  aessages  aay  either  be 
froa  a  resident  AP  or  froa  another  cluster. 

Data  I tea  Picture:  X(14)  Sise  in  Bytes :  14 

Coding  Type:  Alpha/Muaerlc  IDEP1  XRef :  EC  2 

Data  I tea  Stability:  Dynamic  Legal  Value  Set  By. 

Derived  froa  APC  Name 

Where  Used:  APC  Startup 

Value 

Legal  Values _ Representat i on _ Value  Definition 


Mon-VAX-H-MBX 

Mon-IBM-H-MBX 

Mon-HL6-H-MBX 

User-Int-H-MBX 

COMM-VAX-H-MBX 

COMM-IBM-H-MBX 

C0MM-HL6-H-MBX 

CDM-H-MBX 


MR VHbbbbbbbbbb  * 
MR I Kbbbbbbbbbb  * 
MRHHbbbbbbbbbb 
U I VHbbbbbbbbbb 
CO VHbbbbbbbbbb 
CO I Hbbbbbbbbbb 
COHHbbbbbbbbbb 
CDMHbbbbbbbbbb 


VAX  Monitor  APC  Hot 
Mailbox 

IBM  Monitor  APC  Hot 
Mai lbox 

HL6  Monitor  APC  Hot 
Mai lbox 

User  Interface  APC 
Hot  Mailbox 
VAX  COMM  APC  Hot 
Mailbox 

IBM  COMM  APC  Hot 
Mai lbox 

KL6  COMM  APC  Hot 
Mailbox 

CDM  APC  Hot  Mailbox 


•Mote :  The  last  byte  in  the  aailbox  naae  is  reserved  for 
non-NTM  use . 
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Data  Item  Name:  AP  Cluster  Name 


Data  Item  ID:  APCNME 


Data  Item  Description: 

The  AP  Cluster  name  identifies  a  given  occurrence  of  an  AP 
Cluster  residing  on  the  IISS.  An  AP  Cluster  is  defined  as 
a  logically  related  group  of  application  processes  that 
reside  on  a  single  host  machine.  The  processes  are 
collected  at  a  single  AP  Cluster  because  of  their  common 
need  to  access  the  same  database.  A  cluster  may  not  have 
any  database  but  it  will  never  have  more  than  one. 

Each  cluster  within  the  IISS  is  controlled  by  its  own 
occurrence  of  am  HPD.  The  control  by  the  MPU  e:: tends  to 
receiving  messages,  verifying  messages,  rejecting  bad 
messages,  routing  messages  to  their  appropriate 
destination,  and  servicing  the  resident  application 
processes  via  the  AP  Interface. 

The  AP  Cluster  is  always  assigned  to  a  single  logical  host 
but  that  assignment  is  allowed  to  change.  The  tracking  of 
which  logical  host  the  AP  cluster  is  currently  assigned  to 
is  kept  in  the  APC  Status  Table. 

Data  Item  Picture :  X(3)  Size  in  Bytes :  3 

Coding  Type :  Alpha  IDEF1  XRef :  EC  2 

Data  Item  Stabi 1 ity :  Static  Legal  Value  Set  By : 

NTM  Developers 


Where  Used :  Message  Header;  APC  Status  Table;  AP  Information 
Table;  Logon  Table 


Value 

Legal  Values _ Representation 


Value  Definition 


Monitor  AP ' s  APC  on 
the  VAX  Supporting 
the  Operator's 
Console 


Mon-VAX 


MRV 


m  sboiabooo 

I  Boooo *or  IMS 


M«1  ValMt 

him 

MWMWIUUWI 

VilM  Mtiltloa 

Mon-IBM 

Moot  lor  tf's  AFC  oo 
Uw  IH 

Mon-KLB 

* 

Moot  lor  AP  I  AFC  oo 
1*0  MLS 

User- In t 

UIV 

Boor  lolorfooo  AFC 
oo  1*0  VAX 

Cooo-Hdler-VAX 

oov 

VAX  OOH  AF  Cl  ms  tor 

Cooo-Hdler-IBH 

001 

111  000  AF  Clmslor 

Con-Hd  1  or  -MLB 

ooa 

MLS  COM  AF  Clmslor 

COM 

GDM 

CBM  AFC 

D-7 


^V»V 


v'v 
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Data  II—  Bane:  AP  Clut«r  Status  Data  It—  ID:  A  POSTS 

Data  It—  Description: 

The  A P  Clast—  status  id—  tifiss  tlw  current  operational 
status  of  a  fie—  cluster. 

Data  It—  Picture:  X  line  in  Bytes:  l 

Cedi—  Type:  Alpha/Puae ric  IDKF1  XBef :  EC  2 

Data  It—  Stability:  Dynaaic  b— at  Value  Set  By: 

Monitor  AP 


Where  Used :  A PC  Status  Table 

Value 

Led al  Val—  s _ Moores— tat  l  — 

Cl us -Up  1 

Clus-Oaavai 1  2 

Cl  us -Shut  t  inf -Do—  S 


Value  Definition 


Cluster  is  up 

Cluster  is  not 
active 

Cluster  is  in 
Skutdo—  Mode 


Cl us -In-Startup  4 


Cluster  is  in 
startup  Mode 


Clus-Start-Flaf  5 


Cluster  to  be 
started  on  IISS 
startup 
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Data  It—  Wane:  Application  Process  lane  Data  I  tea  ID:  APMAME 
Data  I tea  Description: 

This  data  itea 'identifies  a  unique  ‘generic"  Application 
Process  known  to  the  1188.  An  AP  is  defined  as  a  cohesive 
unit  of  software  within  the  1188  that  can  be  initiated  as 
a  unit  to  perforn  soae  function  or  functions.  Each 
application  process  naae  is  considered  to  be  a  Legal 
Systea  Address. 


The  naaing  convention  for  AP  ntaes  is  to  reserve  the 
first  two  characters  for  the  naae  of  the  subsystea  to 
which  the  AP  belongs.  The  second  three  characters  will 
identify  the  specific  process  within  the  subsystea. 

The  AP  naae  is  the  key  portion  of  the  aessage  header 
source,  destination,  aad  originating  source  fields.  It 
oaaaot.  by  itself,  provide  all  the  inforaation  needed  to 
route  aes sages  aad  is  therefore  concatenated  with 
Instaaoe  (when  known)  aad  resident  AP  Cluster. 


Data  Itea  Picture:  «(8)« 


Else  in  »ytes :  8* 


Type:  Alpha/Muaer ic 


Owner  IDCP1  Utef :  EC  17 


Data  Itea  Etabllity :  Static 


Legal  Value  Bet  By: 

Application  Prograaae 
in  accordance  with  II8S 
naaing  conventions* 


Where  Used .  AP  Inforaation  Table;  Message  Header;  AP  Status 

Table;  Child  Table;  AP  Characteristics  Table;  Logon  Table; 
AP  Operating  Inforaation  Table;  la  Alive  Table;  Authority 
Check  Table  MTM  gystea  Services 


• AP  Maalag  conventions  dictate  an  8  Character  base  Naae 
To  naae  a  two  character  prefix  to  identify  the  directory 
where  the  AP  s  executable  iaage  is  located  is  appended 
.  This  tea  character  naae  is  the  coaeon  reference  to  the  AP 

|  throughout  the  MTM. 

! 


D-e 
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Value 


Mai  Values 

Represen tat i on 

Value  Definition 

Monitor  AP 

MTMOMITV 

Monitor  AP  on  the  VAX 
host  aaohine  MTMOMITI 
Monitor  AP  on  the  IBM 
host  nachine 

VTMOMITH 

Monitor  AP  on  the 
Honeywell  Level  6 

Coeeuni oat Ions 

00MVI00M 

COMM  linking  the  VAX  to 

Handler 

the  IBM 

00MVH00M 

OOMM  linking  the  VAX  to 
the  HL6 

00MIV00M 

OOMM  linking  the  IBM  to 
the  VAX 

OOMIHOOM 

OOMM  linking  the  IBM  to 
the  HL6 

00MHV00M 

OOMM  linking  the  HL6  to 
the  VAX 

00HHI00M 

OOMM  linking  the  HL6  to 
the  IBM 

MPU-Mon-VAX 

MTMRVMPU 

MPU  serving  the  Monitor 
AP's  A  PC  on  the  VAX 

MPU -Mon -IBM 

VTMRZMPU 

MPU  serving  the  Monitor 
AP's  APC  on  the  IBM 

MPU-Mon-KL6 

MTMRKMPU 

MPU  serving  the  Monitor 
AP  s  APC  on  the  HL6 

HPU-User-Int 

MTUIVKPU 

MPU  serving  the  User 
Interface  APC 

MPU -OOMM -Hdl r-VAX 

mtoovmpu 

MPU  serving  the  OOMM 

APC  on  the  VAX 

MPU-OONM-Mdlr-IBM 

rrooiMPU 

MPU  serving  the  OOMM 
APC  on  the  IBM 

D-10 
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Legal  Values 
KPO-COMM-Hdlr 

MPO-CDH 


Value 

Representat 1 on 

Value  Definition 

HL6  VTOOHMPO 

MPU  serving  the  OOMM 

A PC  on  the  KL6 

MTCDKMPU 

MPU  serving  the  CDM  A PC 

DS  620142000 
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Data  It—  Mane:  AP  Cold  Mailbox 


Data  It—  ID:  APCKBX 


Data  It—  Description: 

id— tifies  the  low  priority  aailbox  for  a  given  instance 
of  —  application  process. 


Data  It—  Piotnre:  X(14) 

Cod inf  Type:  Alpha/Bu— ric 
Data  It—  Stability:  Dynaaic 

Where  Used:  Message  Processing  Unit 


Sine  in  Bytes:  14 

IDKP1  IBef :  BC  47 

Ledal  Value  Set  By^ 
AP  Interface 


Bepres— tat  1  on : 


AP 

-Co Id -Mai  lbox 

03 

AP-Ma— 

PIC  X(10). 

03 

AP-Instanoe 

PIC  X(2). 

03 

Mailbox-Type 

PIC  X  Value  "C" 

03 

Filler 

PICX 

D-ia 
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Data  It—  Ma— :  AP  ACT  Mailbox  Data  It—  ID:  APAMBX 

Data  It—  Daaoription: 

IdentITIosthe  nm  of  the  — ilbox  to  which 
acknowledges—  t  —s  sages  are  to  be  s— t. 

Data  It—  Picture:  X(14)  01—  in  Bytes :  14 

Coding  Type :  Alpha/M— eric  IDgTl  XBef :  IC  47 

Data  It—  gtablllty:  Dynaalc  Legal  Val—  Set  By: 

AP  Interface 


Where  Used:  Message  Processing  Unit 


Kepresen tat 1 on : 


01  AP-ACX -Mail box 

05  AP-Maae 

05  AP-Instanoe 

05  Mailbox-Type 

05  Pi  Her 


PIC  X(10). 

PIC  X( 2) . 

PIC  X  Valve  “A* 
PICK 
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Data  It— 


A?  lot  Mailbox 


Data  Item  ID:  APHKBX 


Data 


Item 

Ti« 

of  i 


Description: 

itTfiestKe  low  priority  mailbox  for  a  fiven  iastaaoe 
a  appl i cation  prooess . 


Polo  11—  Plolure:  Z(  14) 


Alpba/Buae rio 


Data 


SlabllllT:  Dymaaio 


81—  in  Bytes:  14 

IDBF1  XBef :  SC  47 

L— al  Value  —1  »y: 
Ar  Interfaoe 


V— re  Peed:  Me*  safe  Prooess  inf  Omit 


-Hot -Mail box 

AP- Marne 
AP- Iastaaoe 
Mai 1 box -Type 

fi 1 ler 


PIC  1(10). 

PIC  X(2). 

PIC  X  Value  "B" 
PICX 


D  14 


Wi 
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Data  It—  B — e :  AP  Priority 


Data  It—  ID:  APPRO 


Description: 
priority  lovol 
Process . 


assign—  to  a  giv—  Application 


Pfcta  It—  Picture :  X  81—  in  Bytes:  1 

Coding  Type:  Alpha /Rune rio  IDEF1  XRef :  EC  17 

Data  It—  Btabl  1 1  ty :  Static  Legal  Value  Set  By: 

Where  Os—:  Message  Header;  AP  Charaoteristios  Table 

Value 

Legal  Values _ Representation _ Value  Definition 

Default  0  Default  AP  Priority 

for  the  Test  B— 


D-15 
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Data  I tea  Haae:  Application  Process  Status  Data  I tea  ID:  APSTAT 
Data  I tea  Description: 

This  itea  defines  the  current  operational  status  of  a 
given  initiated  instanoe  of  an  application  prooess. 


Data  Itea  Picture:  X 
Coding  Type:  Alpha/Nuaeric 
Data  Itea  Stabi 1 ity :  Dynaaic 


Where  Psed:  AP  Status  Table 

Value 

Legal  Values _ Representat i on 

AP-Init  0 


AP-Abort  1 

AP-Dead-Act-Cld  2 

AP-Dead  3 

Await-Inl t 

Ini t -Cane  5 

Shut -Down-Mode  6 


Slse  in  Bytes :  1 

IDEF1  XRef :  EC  16 

Legal  Value  Set  By: 
AP's  MPU 

Bote:  All  of  these 
values  are  applied 
to  an  AP  instance  - 
Mot  to  the  ‘‘generic" 
AP 


Value  Definition 


AP  is  in  initiation 
node  ("I  a  alive" 
asg  has  not  yet 
arrived  at  MPU) 

AP  has  been  aborted 

AP  has  terainated 
but  its  child  AP(s) 
are  still  active 

AP  has  noraally 
terainated 

AP  is  waiting  for  an 
initiation  aessage 

AP's  initiation  was 
canceled 

AP  is  in  the  process 
of  shutting  down 
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Legal  Values 

Value 

Representat i on 

Value  Definition 

In-Recovery 

7 

AP  i6  in  recovery 
node 

In-Wait 

8 

AP  is  waiting  on  a 
response  to  a  paired 
message 

Shut-Down 

9 

AP  has  completed 
shutdown  and  is  dead 

Recovered 

A 

AP  has  finished 
recovery  and  i s 
available  for 
initiation 

AP -Executing 

B 

AP  is  executing 

| 

i 


D-17 


DS  620142000 
1  November  1965 


Data  Ilea  Mame :  Authorisation 

Requirement 


Data  Item  ID:  AOTREQ 


Data  Item  Description: 

The  authorisation  requirement  identifies  whether  a  message 
conforming  to  a  given  category  needs  to  have  the  authority 
of  its  sender.  Message  Type,  and  receiver  checked. 

Data  Item  Picture:  X  Sise  in  Bytes :  1 

Coding  Type:  Alpha/Mumeric  IDEF1  XRef :  EC  36 

Data  Item  Stability:  Static  Legal  Value  Set  By: 

Message  Category 


Where  Psed:  Message  Category  Table 

Value 

Legal  Values _ Represen  tat  1  on _ Value  Definition 


Aut-Yes 


1 


Authorise  Message 


Aut-Mo 


0 


Don't  Authorise 

Message 
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Data  It—  B—  :  Astkor  1  sad  to  Baoai va  Data  It—  ID:  ATOMEC 


Data  It—  Dascrlptloa : 

Tills  it—  is  mot  a  para  data  it—.  It  Is  tkt  aa—  of  ike 
f laid  ia  tka  Aatkoritf  Tab la  tbat  coa talas  tba  AP  Isas 
that  is  aatbor isad  to  raoaiaa  a  fim  sa ssafa  Typa  fr—  aa 
AP  Sa—  tbat  is  —tborisad  to  saad  tba  sa—  giv—  — ssaga 
typa.  Tba  f laid  aa—  Aafi— s  tba  faactioa  of  tba  aaloas 
tbat  ara  ooataiaad  la  tba  fiald. 

Tba  aalaas  la  tba  fiald  ara  rapras— tad  as  tba  AP  Sa— 
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Data  Hern  Name:  Authorised  to  Send  Data  Item  ID:  ATOSND 

Data  Item  Description: 

This  item  (as  Authorised  to  Receive)  is  a  field  name  in 
the  Authority  Table  which  defines  the  function  of  the 
values  that  are  contained  in  the  field.  The  value  in  this 
field  of  the  Authority  Table  i6  the  AP  Name  that  is 
authorised  to  send  a  given  message  type  to  another  AP  that 
is  authorised  to  receive  the  same  given  message  type. 

The  values  in  this  field  are  AP  Names  and  are  represented 
as  defined  for  the  AP  Name  data  item. 


> 


1 


DC  630143000 
Kivwhtr  1065 


Data  lien  Baae:  Binary/Mative  Flag 


Data  It—  ID:  BXBBAT 


Data  I tea  Description: 

Identifies  the  generic  type  of  data  contained  in  the  data 
portion  of  a  Message.  Binary  indicates  that  the  data  is  in 
the  host  Machine's  internal  representation  fora  whereas 
native  indicates  that  the  data  is  character  data 
represented  by  the  host  Machine's  character  code  (ASCII. 
EBCDIC,  etc.). 


Data  I tea  Picture:  X 
Coding  Type:  Alpha/Muneric 
Data  I tea  Stability:  Dynaaic 


Where  Used:  Message  Header 


Legal  Va lues 
Binary 


Value 

Represen tat i on 


Native 


D-21 


Slse  in  Bytes :  1 

IDEFl  XRef :  EC  10 

Legal  Value  Set  By: 
User  (or  default) 


Value  Definition 

Message  is  encoded 
in  binary  aode 

Message  is  encoded 
in  native  aode 
(default  value) 


T. 


DC  M0I42000 

1  Cnmhir  IMS 


Ml  OumwI  ZD  ia  tho 
allaoatad  to  *  asar  at  lofsa.  This  1 
*  lofioal  OkMMl  XD.  Xt's  valaa  is 
as  a  f laid  la  tfca  Logom  Tabla. 


raa|o  of  ZD's 
aa  is  rsprM* 

o.  Zi  is 
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DS  490149000 
>r  IMS 


(Hi  14  Saak 


I±**  IE i  mu 


8148  4*LSfl^4ffW  M.iO-  to  Ik.  okild  *,  ,u  ekUd 

table  entry  la  or  eat  ad .  The  raak  loosely  oorrelates  to 
ike  order  la  wbiob  iko  obi  Id  AT '  s  ara  spamod.  Tko  raak 
■Maker  is  ued  la  ooabiaatioa  with  Ike  Parent  AP  Me—  as  a 
liak  list  polater  tkreMfk  tbo  obi Id  Tabla. 


Data  I taw  Picture:  9(4) 

Cod  lad  Tree  :  Mu— ric 

Data  Itaa  Stability:  Dynaaic 


lisa  in  Irtes ■  4 
IDCTl  Xftef:  EC  81 


Ladal  Value  Sat  By : 


Osar  (or  default. 


Vhara  Osad:  Child  Tabla 


Ledal  Values 


Value 

Kaprasaatat 1 on 


Value  Def lnition 


0001 >9999 
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DlU  It—  Sa— :  a— I  Ulfa  start  Data  It—  IP:  CHAMST 

*fS  ?©I —^Logical  Chaanal  ID  la  tha  raaga  of  ID's 
al looatad  to  a  usar  at  Logoa.  This  it—  is  raprasantad  as 
a  bogioa  1  Chaanal  ID.  It's  valua  is  dynaa  ic.  Tha  itaa  is 
asad  as  a  fiald  ia  tha  Logoa  Tabla. 


D-24 
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D>U  II—  Bane:  Child  Status  Dele  It—  ID:  CLD6T8 

Pete  It—  Dos  cr lotion: 

This  it—' 11®# i nos  the  current  operational  status  of  a 
given  child  AP.  The  status  values  provided  are  only  In 
terns  of  the  ohild's  relation  to  the  Par— t  AP.  The 
status  of  the  child  AP  as  —  —  tity  —to  itself  is 
provided  in  the  AP  Status  Table. 

Data  I ten  Picture:  X  Sise  in  Bytes :  1 

Coding  Type:  Alpha/Huneric  IDEP1  X  Ref. :  SCSI 

Data  I ten  Stability:  Dynamic  Legal  Value  Set  By: 

Child  AP's  MPO 


Where  Used:  Child  Table 


Values 

Value 

Representat i on 

Value  Definition 

Abort -ACK 

1 

Abort  Message  sent 
to  child  AP  has  been 
acknowledged 

N-Tern-No-Cld 

2 

Child  AP  has 
normally  terninated 
leaving  no  active 
children  of  its  own 

SD-APC 

3 

Child  AP  has  been 
shutdown  in  APC  SD 

Mode 

SD-AP 

4 

C.iild  AP  has  been 
shutdown  in  AP  SD 
mode 

SD-Host 

5 

Child  AP  has  been 
shutdown  in  Host  SD 
mode 

CLD-Initiated 

6 

Child  AP  has  been 
initiated 
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I 


M  M014S000 
•YWb mr  IMS 


V»lM 

Kit*  Ytlltt _ Htwwwuuwi _ Yflff  PtntlMgg 

loml-Ttra-  T  Ok  lid  A?  kas 

Vitk-Ckild  Boraally 

UralMitd  lBBvlmf 
Mtivt  children 
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GO  000140000 
loveaber  100ft 


001  Id  Table  laden 


Dale  It—  ID:  CLD10D 


la  tbe  AT  Status  Table  to  serve  as  aa 
lad—  to  tbe  flv—  AT  Iastaaoe's  first  — t  ry  la  tbe  obi  Id 


states  table.  It  Is  a  dyaulo  It—  whose  values  are 
deteralaed  wh—  tbe  Gblld  Table  —try  Is  wrlttea.  It  it 
repres— t—  la  GOGOL  as  TIC  0(4) 


Y*  liVUV*r 


.*••*■* 


»%  1 


08  880148000 
1  lovwbir  1888 


DiU  It—  If:  Children  feU  It—  ID:  CHLOM 

^  Hi— fTITe^whether  a  flv—  AP  has  any  ohild  AP's 
assoolatad  with  it. 

Data  It—  Plctnre:  X  81—  in  Bytes :  1 

IDXn  XRef :  SC  51 

Legal  Value  Set  By: 
Local  MPO 


Value  Definition 

Mo-Kids  0  AP  has  no  associated 

ohild  AP's 

Kids  1  AP  has  associated 

child  AP's 


Coding  Tv—:  Alpha/Hu— ric 
Data  It—  Stahl  1 1  ty :  Dynaaic 

Where  Deed:  AP  Status  Table 

Value 

Legal  Values  Representation 


08  630142000 
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Data  It—  Ba— :  Continuation  Indioator 

Data  It 
f 

larfar  group  of  — asafoa 

Data  It—  Ploturo:  X 

Coding  Typo :  Alpha/Mu— rio 

Data  I ton  Stability:  Dynamic 
AP  Interface 

Where  Used:  Message  Header 
Legal  Values 


Data  It—  ID:  OOMIMD 


It—  Desorlotlon: 

This  it—  Id— tifies  whether  a  giv—  — ssage  is  part  of  a 


Sine  in  Bytes :  1 
IDEP1  XRef :  EC  19 
Legal  Value  Set  By: 


Value 

Representat 1 on 


Value  Definition 


Pirst  Part  1 


Hot  Continued  0 


Message  is  the  first 
part  of  a  larger 
group  and  is 
continued 

Message  is  complete 
within  itself 


Middle  Part  2 


Message  is  somewhere 
in  the  middle  of  a 
continued  message. 


Last  Part 


3 


Message  is  the  last 
part  of  a  continued 
message . 
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Data  II—  Maae:  Data  Coda  Data  It—  ID:  DATACD 

Data  It—  Description: 

This  it—  is  used  in  tba  I'M  Alive  Table  to  indicate 
whether  there  is  data  waiting  to  be  delivered  to  the  AP 
upon  the  MFC's  reoeipt  of  the  "I ‘a  Alive*  — ssage.  This 
it—  applies  to  — ssages  that  both  cause  an  initiation  to 
occur  and  carry  data. 


Data  I ten  Picture:  X 

Sise  in  Bytes:  1 

Coding  Type: 

Alpha/Mu—  ric 

IDEF1  X  Ref . :  M/A 

Data  Itea  ''Stability'':  Dynamic 

Legal  Value  Set  By: 

Destination  MPU 

Where  Used :  I ' 

a  Alive  Table 

Legal  Values 

Value 

Representat i on 

Value  Definition 

Mo-Data 

1 

Mo  data  waiting 

Data-Waiting 

2 

Data  Waiting  in 
buffer 

Data- In-Next - 
Msg 


3 


Data  Arguments  are 
coning  in  another 
ne ssage 


D6  680142000 
1  lovobsr  1085 

Data,  It—  Baae:  Data  Length  Data  It—  ID:  DATLEM 

Data  Itaa  Description: 

This  fiald  — ists  in  the  —stage  header  to  indicate  the 
1— gth  of  the  actual  data  portion  of  the  — ssage. 

Data  It—  Pioture:  X(4)  Sise  in  Bytes :  4 

Coding  Type:  Alpha/Muaeric  IDEF1  XRef :  EC  19 

Data  It—  Stabl  1  lty :  Dynaaic  Legal  Value  Set  By: 

Message  Source  AP 

Where  Used:  Message  Header 
Value  Range:  0000-9999 


r  IMS 


Delay  Tiae  Trigger 


Data  Ilf  ID: 


Data  1U§  Description : 

~~fkm  trigger  tiae  represents  tbe  tiae  vale#  to  ht  used  in 
ooajeaotioa  vitli  a  specified  delay  trigger  ooaditioe 

Data  I  tea  Picture:  XUS)  tise  ia  lutes  IS 


Cod lad  Type:  Alpha/ 


Data  I tea  Stab! 1 1  ty :  Dyaaaic 


tise  la  lutes:  is 

iDiri  mef  sc  10 

Ledal  Value  Set  lu 
ftouroe  AP  or  Systee 
Default 


Where  Psed:  Message  Meador 

Represen tat 1 on :  These  in  nuaber  of  100  as  increaents 


D-32 


1 


r  IMS 


I  11111 


D-33 


Ht« 


lit?  i» 


weio*  the 


1  Taljf  IlS  m 

n  Af  or  ty«t< 
■  It 


nr 


Dal  Ivor  uy  t  Im 
tfUr  &  iptcififtd 
tiM  ( see  Delay  TIm 
Trigger) 

D«  1 1 ver  upon  a 
specified  condition 
or  avant  (see  Delay 
Trigger  condition) 

Deliver  at  a 
specified  tine 
(see  Delay  Tine 
Trigger) 

Deliver  right  now 
(systea  default) 


'WWW 
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DfcU  It—  Name:  Delay  Trigger  Data  I tea  ID:  TRGCOM 

Condition 


Data  Item  Description: 

The  trigger  condition  specifies  the  actual  condition  under 
vhioh  a  message  is  required  to  be  delivered. 


Data  Item  Pioture:  X 
Coding  Type:  Alpha/Nuaeric 
Data  Item  Stability:  Dynamic 


Size  in  Bytes :  1 

IDEF1  XRef :  EC  19 

Legal  Value  Set  By : 
Souroe  AP  or  System 
Default 


Where  Used:  Message  Header 


Value 

Legal  Values _ Representat i on _ Value  Definition 

TBD 
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Data  lig  Maae:  Guaranteed  Delivery  Data  I tea  ID:  GOARDL 

Data  Itea  Description: 

This  itea  indicates  whether  a  Message  conforaing  to  a 
given  category  requires  guaranteed  delivery  services. 

These  servioes  involve  a  oonoerted  effort  to  insure  the 
delivery  of  the  Message  to  its  destination  AP. 

Data  Itea  Picture:  X  Sise  in  Bytes :  1 

Coding  Type:  Alpha/Huaeric  IDEF1  XRef :  EC  36 

Data  Itea  Stability:  Static  Legal  Value  Set  By: 

Message  Category 


Where  Used:  Message  Category  Table 


Value 

Legal  Values _ Representation _ Value  Definition 

! 

GD  1  Message  Delivery  is 

Guaranteed 


Mo-GD 


0 


Message  Delivery  is 
not  Guaranteed 
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Data  I tea  gage:  Guaranteed  Delivery  Flag  Data  Itea  ID:  GDPLAG 
Data  Itea  Description : 

This  flag  is  set  when  the  AP  instance  is  the  source  of  one 
or  aore  guaranteed  delivery  aessages  that  have  yet  to  be 
delivered.  Further  data  on  these  outstanding  guaranteed 
delivery  aessages  is  aaintained  in  the  guaranteed  delivery 
table. 

Data  Itea  Picture:  X  Slse  in  Bytes :  1 

Coding  Type:  Alpha/Nuaeric  IDEF1  XRef :  EC  16 

Data  Itea  Stability:  Dynaaic  Legal  Value  Set  By: 

AP ' s  MPU 


Where  Deed:  AP  Status  Table 

Value 

Legal  Values _ Represen  tat  i  on 

GD-Out  1 

No-GD  0 


Value  Definition 


The  AP  instance  has 
guaranteed  aessages 
outstanding-Flag  is 
set 

The  AP  instance  has 
no  gauranteed 
delivery  aessages  - 
Flag  not  set 
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Data  Ilea  Name:  Header  Format  Data  Item  ID:  HDRFHT 

Indloator 

Data  I tea  Description: 

The  header  format  ID  Identifies  the  particular  format  of 
the  given  message  header.  The  value  of  this  item  has  no 
relationship  to  the  data  portion  of  the  message. 


Data  Item  Ploture:  X 
Coding  Type:  Alpha/Huaeric 
Data  Item  Stability:  Static 

Where  Used:  Message  Header 

Value 

Legal  Values _ Representat  1  on 

A  A 


Slse  in  Bytes:  1 

IDEF1  XRef :  EC  19 

Legal  Value  Set  By: 
HTM  Developers 


Value  Definition 


Header  Format  A 


D-37 
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Data.  I  tea  Maae:  Header  Length  Data  Itea  ID:  HDRLEH 

Data  Itea  Description: 

Specifies  the  length  (in  bytes)  of  the  HTM  header  portion 
of  the  aessage. 

Data  Itea  Picture:  X(S)  Sise  in  Bytes:  S 

Coding  Type:  Alpha/Muaeric  IDEP1  XRef :  EC  19 

Data  Itea  Stability:  Static  Legal  Value  Set  By: 

HTM  Developers 

Where  Used:  Message  Header 


Value 

Legal  Values _ Representat  1  on _ Value  Definition 

A-092  092  The  length  of  Header 

Foraat  A 


Value  Range:  001-999 
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Data  I  tea  Name;  Host  Status  Data  Item  ID:  HSTSTS 

Data  Item  Description: 

The  host  status  identifies  the  ourrent  operational  status 
of  a  given  physioal  host  machine. 

Data  Item  Picture:  X  Slse  in  Bytes :  1 

Coding  Type:  Alpha/Muaeric  IDEF1  IRef :  EC  1 

Data  Item  Stability:  Dynamic  Legal  Value  Set  By: 

NTH 

Where  Used:  Host  Status  Table 


Value 


Legal  Values 

Represen tat i on 

Value  Definition 

Op 

1 

Machine 

is 

running 

Down 

0 

Machine 

is 

dead 

In-Start 

2 

Machine 

brought 

is 

up 

being 

In-Shutdown 

3 

Machine 

process 

down 

is 

of 

in  the 
shutting 

D-39 
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Data,  Itw  Bane:  Initiation  Meads  Data  I  ten  ID:  IMIBDS 

Data  I ten  Description: 

Defines  vhei-l&er  a  given  AP  requires  a  specifio  initiation 
■essage  (Category  B)  in  order  to  be  started. 

Data  I ten  Pioture:  Z  Slse  in  Bytes :  1 

Coding  Type:  Alpha/Bunerio  IDBF1  X  Ref. :  EC17 

Data  I ten  Stability;  Statio  Legal  Value  Set  By: 

AP  Developer 


Where  Used:  AP  Character istios  Table 

Value 

Legal  Values _ Representat  1  on _ Value  Definition 


Mo-Restric  0 
Meeds -In it -Msg  1 
Start-Fron-Tern  2 


AP  can  be  initiated 
by  any  nessage 

AP  requires  specific 
initiation  nessage 

AP  is  initiated  fron 
a  terninal-not 
started  by  the 
NTM 
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Pat*  I tea  Maae:  Instanoe  Data  I tea  ID:  IMSTMC 

Data  I tea  Description: 

An  Identifier  assigned  to  every  instance  (Initiated 
ooourrenoe)  of  a  given  AP .  The  instance  serves  to  uniquely 
identify  one  initiated  (awake)  AP.  In  the  case  of  the  User 
Interface  AP,  the  instanoe  will  aap  to  a  specific  terainal 
(or  screen,  in  aultlsoreen  node).  The  instance  identifier 
is  associated  with  an  AP  froa  its  initiation  until  the  AP 
and  its  associated  lnstaoes  are  cleaned  up. 

Data  I tea  Picture:  X(2)  Size  in  Bytes :  2 

Coding  Type:  Alpha/Muaeric  IDEF1  XRef :  EC  16 

Data  I tea  Stability:  Dynaaio  Legal  Value  Set  By: 

Local  MPU 

Where  Used:  AP  Status  Table;  Message  Header;  I 'a  Alive  Table 
Value  Range:  01-99 
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Data  I  tea  Maae:  Instances  Currently  Data  I  tea  ID:  NXJMIMS 

Running 

Data  I tea  Description: 

This  data  itea  identifies  the  nuaber  of  instances  of  a 
given  AP  which  are  currently  in  soae  stage  of  operation. 

Data  Itea  Picture:  X(2)  Sise  in  Bytes :  2 

Coding  Type:  Alpha/Nuaeric  IDEF1  XRef :  EC  16 

Data  Itea  Stability:  Dynamic  Legal  Value  Set  By: 

Local  MPU 

Where  Used:  AP  Operating  Information  Table 
Value  Range:  00-36 
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Data  I tea  Kaae;  Integrity  Check  Flag  Data  I tea  ID:  IMTCHK 


Data  I tea  Description: 

Indicates  whether  the  data  portion  of  a  given  aessage 
should  be  validated  against  the  data  foraat  specified  in 
the  aessage  header. 


Data  I tea  Picture:  X 
Coding  Type:  Alpha/Nuaeric 
Data  I tea  Stability:  Dynaaic 


Size  in  Bytes :  1 

IDEF1  XRef :  EC  19 

Legal  Value  Set  By: 
Source  AP  or  Systea 
Default 


Where  Used:  Message  Header 


Value 

Legal  Values _ Represen  tat  i  on 


Value  Definition 


Check  1  Data  portion  is  to 

be  checked  for  data 
integrity 

No-Check  0  Data  portion  is  not 

to  be  checked 
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Data  I tea  Waae:  Last  Instance  Number  Data  Item  ID:  LSTINS 

Assigned 

Data  Item  Description: 

This  item  provides  the  value  of  the  last  instance  number 
assigned  to  an  instance  of  a  given  AP. 

Data  Item  Picture :  X(2)  Size  in  Bytes :  2 

Coding  Type:  Alpha/Numeric  IDEF1  XRef :  EC  17 

Data  Item  Stability:  Dynamic  Legal  Value  Set  By: 

MPU 

Where  Used:  AP  Operating  Information  Table 
Value  Range:  01-99 
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Data  Item  Name:  Last  Key  Pointer  Data  Item  ID:  LSTKEY 

Data  Item  Description: 

Pointer  to  the  last  key  value  assigned  for  a  given  AP  for 
messages  queued  in  the  AP  queue. 

Data  Item  Picture:  X(9)  Size  in  Bytes :  9 

Coding  Type:  Alpha/Humeric  IDE FI  XRef :  EC  16 

Data  Item  Stabl 1 ity:  Dynamic  Legal  Value  Set  By: 

MPU 

Where  Used:  AP  Status  Table 
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Dai'a  Item  ll&me:  Link  ID 


Data  Item  ID:  LINKID 


Data  Item  Description: 

The  identification  of  a  specific  communications  link 
between  two  physical  host  machines.  The  link  is  maintained 
by  "sibling"  COMM  AP's. 

Data  Item  Picture:  X(2)  Size  in  Bytes :  2 

Coding  Type:  Alpha/Mumeric  IDEF1  XRef :  EC  48 

Data  Item  Stabl 1 i ty :  Static  Legal  Value  Set  By : 

MTM  Developers 

Where  Used:  Link  Status  Table 


Value 

Legal  Values _ Represen  tat  1  on 


Value  Definition 


VAX- IBM  VI 

IBM-HL6  IH 

VAX-HL6  VH 


Link  between  the  VAX 
11/780  and  the  IBM 
3033 

Link  between  the  IBM 
3033  and  the 
Honeywe 1 1  Leve 1  6 

Link  between  the  VAX 
11/780  and  the 
Honeywell  Level  6 
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Data  I tea  Wage;  Link  Status  Data  I tea  ID:  LKLSTAT 

Data  I tea  Description: 

The  current  operational  status  of  a  given  link. 

Data  I tea  Picture:  X  Sise  in  Bytes :  1 

Coding  Type:  Alpha/Huaeric  IDET1  X  Ref. :  EC48 

Data  I tea  Stability:  Dynaalc  Legal  Value  Set  By: 

VAX  Monitor  AP 


Where  Used:  Link  Status  Table 

Value 

Legal  Values _ Represen  tat  i  on _ 

Active  1 

Inactive  0 

Started  2 

has  been  sent -no 
return  yet 


Value  Definition 
Link  is  Active 
Link  has  failed 
Start  Link  nessage 


I 


f 

I 

I 


( 
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Data  I tea  Bane:  Log  Requirement  Data  Item  ID:  LOGREQ 

Data  I tea  Description: 

The  log  requireaent  identifies  whether  a  aessage  is  to  be 
logged  based  upon  the  given  aessage  category.  In  the  Test 
Bed  all  aessages  will  be  logged.  For  future  releases, 
logging  will  be  restricted  to  certain  aessage  categories 
in  accordance  with  the  requireaents  defined  by  the 
reoovery  function. 

Data  I tea  Picture:  X 


Coding  Type:  Alpha/Muaeric 
Data  I tea  Stability:  Static 


Where  Psed:  Message  Category  Table 

Value 

Legal  Values _ Represen  tat  1  on _ Value  Definition 

Yes  1  Log  the  Message 

Bo  0  Don’t  log  the 

aessage 


Sise  in  Bytes :  1 

IDEF1  XRef :  EC  36 

Legal  Value  Set  By: 
Message  Category 


D-48 
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Data  It—  Maae:  Logical  Channel  ID  Data  I  tea  ID:  CHAN  ID 


Data  Itea  Description: 

This  itea  identifies  a  logical  connection  between  two  or 
aore  awake  APs.  This  connection  is  established  in  two 
oases.  The  first  oase  involves  the  aaintenance  of  a 
"faaily  tree*  of  AP  instances.  The  seoond  oase  serves  to 
identify  a  unique  pair  of  aessages. 

Data  Itea  Picture:  X(5)  Size  in  Bytes :  5 

Coding  Type:  Alpha/Muaeric  IDEF1  XRef :  EC  50 


Data  Itea  Stability:  Dynaaio 


Legal  Value  Set  By: 
Original  Source  AP 
AP  Interface  (for 
default) 


Where  Used:  Message  Header;  Message  Pairing  Table;  AP  Status 
Table;  Child  Status  Table. 


Representat 1 on :  Any  coabination  of  3  Alpha  or  Buaerlc 

characters . 
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Data  I tea  Maae:  Logical  Host  Naae  Data  I tea  ID:  HSTNAM 

Data  I tea  Description: 

Host  naae  identifies  an  instance  of  a  logical  host  within 
a  physical  host  aachine  on  the  IISS.  The  logical  host  has 
a  nuaber  of  AP  Clusters  assigned  to  it. 

Data  I tea  Picture:  X(3)  Slag  in  Bytes :  3 

Coding  Type:  Alpha/Huaeric  IDEF1  XRef :  EC  41 

Data  I tea  Stability:  Static  Legal  Value  Set  By: 

Where  Psed:  Host  Status  Table;  AP  Cluster  Status  Table 
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Data  Item  Marne:  Maximum  Instances  Data  Item  ID:  MAXIMS 

Data  Item  Description: 

This  item  defines  the  maximum  number  of  instances  of  a 
given  AP  that  can  be  initiated  at  any  given  time. 

Data  Item  Picture:  X(2)  Sise  in  Bytes :  2 

Coding  Type:  Alpha/Muneric  IDEF1  XRef :  EC  17 

Data  Item  Stabl 1 ity :  Static  Legal  Value  Set  By: 

Where  Psed:  AP  Characteristics  Table 
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Data  I tea  gage:  Maximum  Number  of  Data  Item  IP:  VOAMSG 

Queued  Messages 

Data  Item  Description: 

This  item  identifies  the  maximum  number  of  messages  that 
are  allowed  to  be  in  a  given  (generic)  AP's  queue  at  any 
one  time. 

Data  Item  Picture:  X(2)  Slse  in  Bytes :  2 

Coding  Type:  Alpha/Wumeric  IDEP1  X  Ref. :  EC17 

Data  Item  Stabl 1 1 ty :  Static  Legal  Value  Set  By: 

AP  Developer 


Where  Psed:  AP  Characteristics  Table 
Value  Range :  00-99 
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Data  I tea  Name:  Message  Category  Data  Item  ID:  MSGCAT 

Data  Item  Description: 

The  message  category  defines  processing  required  by  the 
message.  The  category  implies  the  level  of  processing 
needed  to  establish  the  overall  acceptability  of  the 
message.  It  also  specifies  oertain  special  services  the 
NTH  is  required  to  provide. 

Data  Item  Picture:  X  Slse  in  Bytes :  1 

Coding  Type:  Alpha  IDEF1  XRef :  EC  36 

Data  Item  Stabi 1 lty :  Static  Legal  Value  Set  By: 

NTM  Developers 

Where  Used:  Message  Header;  Message  Category  Table 

Value 

Legal  Values _ Represen  tat  1  on _ Value  Definition 


Guar-Del 

A 

Message  requires  a 
Guaranteed  Delivery 
Service 

Resp-Reqd 

B 

Response  Required 

SysCoad-Mo  Resp 

C 

System  Command  -  No 
Response  Required 

Syscomd-Resp 

D 

System  Command  - 
Response  Required 

Unsol-Msg 

E 

Unsolicited  Message 

Sol -Msg 

F 

Solicited  Message 

ApStatus-Msg 

G 

AP  Status  Message 

Ini t-Msg-No- 
Response 

H 

Message  specifically 
requires  the 
initiation  of  an  AP 
Instance 
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Legal  Values 
Msg-Froa-OOMM 


Ini t-Msg-Response 
Required 


Value 

Repr esentat l on 
I 


J 


Value  Definition 


Message  having  a 
OOMM  AP  as  its 
souroe 

Paired  Specific 

initiation 

aessage 


D-  54 
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Data  Item  Marne:  Message  Destination  Data  Item  ID:  MSGDST 

Data  Item  Description: 

The  Application  Process  that  is  the  receiver  of  the  given 
message.  The  destination  is  defined  as  the  combination  of 
the  receiving  AP  name,  instance  (if  known) ,  and  resident 
AP  Cluster.  It  is  represented  in  the  message  header  as: 

10  HDR  MSGDST 

15  MD  APMAME  X(10) 

15  MD  IMSTMC  X(2) 

15  MD  APCMME  X(3) 

This  item  is  used  in  the  Guaranteed  Delivery  table  to  identify 
the  destination  of  a  given  GD  message. 
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Data  Item  Mage;  Message  Log  Time  Stamp  Data  I tea  ID:  TSTAMP 
Data  I tea  Description: 

The  host  system  clock  tlae  at  the  ooourrenoe  of  a 
particular  event. 

Data  Item  Picture:  X(23)  Slse  In  Bytes:  23 

Coding  Type:  Alpha/Nuaeric  IDEF1  XRef :  H/A 

Data  I tea  Stability:  Dynamic  Legal  Value  Set  By: 

Host  OS 

Where  Used:  Message  and  Error  Log 
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Data  Xtea  Marne :  Message  Priority  Data  I tea  ID:  M8GPRY 

Data  I tea  Description: 

The  priority  code  identifies  the  processing  priority 
assigned  to  a  aessage  oonforaing  to  a  given  message 
category . 

Data  I tea  Picture:  X  Slag  in  Bytes :  1 

Coding  Type:  Alpha/Nuaeric  IDEF1  XRef :  EC  36 

Data  I tea  Stability:  Static  Legal  Value  Set  By: 

Message  Category 

Where  Used:  Message  Header;  Message  Category  Table 

Value 

Legal  Values _ Representat i on _ Value  Definition 


Hot  1  Message  has  high 

priority 


Cold 


0 


Message  has  low 
priority 
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Data  Item  Marne;  Message  Queue  Flag  Data  Item  ID;  MSQQUF 

Data  Item  Description; 

This  item  is  a  flag  that  is  set  when  there  are  messages  in 
queue  waiting  for  a  specified  AP  Instance. 

Data  Item  Picture:  X  Sise  in  Bytes :  1 

Coding  Type:  Alpha/Mumeric  IDEF1  XRef :  EC  16 

Data  Item  Stability:  Dynamic  Legal  Value  Set  By: 

Local  MPO 


Where  Used:  AP  Status  Table 

Value 

Legal  Values _ Representat i on _ Value  Definition 


Msg-In  1  There  are  messages 

in  the  queue  for  the 
AP  Instance  >  Flag 
is  set 

No-Msg  0  There  are  no 

messages  in  the 
queue  -  No  flag 
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Palm  Item  Name :  Message  in  Queue  Data  Ilea  ID:  MMSG 

Data  I tea  Description: 

Identifies  the  nuaber  of  messages  currently  queued  for  a 
given  AP  instance. 

Data  I tea  Picture:  X(4)  Slse  in  Bytes :  4 

Coding  Type:  Alpha/Nuaer ic  IDEF1  XRgf :  EC  16 

Data  I tea  Stability:  Dynamic  Legal  Value  Set  By: 

Local  MPU 


Where  Used:  AP  Status  Table 
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Data  Item  Name:  Message  Serial  Number  Data  Item  ID:  MSGSN 
Data  Item  Description; 

A  number  that  is  assigned  to  each  message  by  its  source 
MPU  AP  Cluster.  The  number  itself  is  unique  only  within  an 
AP  Cluster.  In  order  for  the  message  to  be  uniquely 
identifiable  within  the  IISS,  the  serial  number  is 
concatenated  with  the  source  AP  Cluster  name. 

Data  Item  Picture:  X(7)  Size  in  Bytes :  7 

Coding  Type:  Alpha/Numeric  IDEF1  XRef :  EC  19 

Data  Item  Stability:  Dynamic  Legal  Value  Set  By: 

Source  MPU 

Where  Used:  Message  Header;  Guaranteed  Delivery  Table 
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Data  I tea  game:  Message  Serial  Number  Data  Item  ID:  SERNLQ 

Last  Queued 

Data  Item  Description : 

The  serial  number  and  souroe  AP  Cluster  of  the  last 
aessage  written  to  the  message  queue  for  a  given  AP 
instance.  The  value  representation  is  taken  froa  the 
header  of  the  aessage. 

This  data  itea  is  maintained  for  recovery  processing 
purposes . 

Data  Itea  Picture:  X(10)  Size  in  Bytes :  10 

Coding  Type:  Alpha/Nuaeric  IDEF1  XRef :  EC  16 

Data  Itea  Stability:  Dynamic  Legal  Value  Set  By: 

Local  MPU 


Where  Used:  AP  Status  Table 
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Data  I tea  Maae:  Message  Souroe  Data  I tea  ID:  MSG8RC 

Data  Itea  Description: 

The  Application  Process  that  is  the  iaaediate  sender  of  a 
given  aessage.  The  souroe  is  defined  as  the  ooabination  of 
the  sending  AP's  naae,  instance,  and  resident  AP  Cluster. 
It  is  represented  in  the  aessage  header  as: 

10  HDR  MSGSRC 

15  MS  APMAME  PIC  Z(10) 

15  MS  IMSTMC  PIC  X(2) 

15  MS  APCMME  PIC  X(3) 

This  itea  is  used  in  the  Guaranteed  Delivery  table  to  identify 
the  source  of  the  given  GD  aessage. 


i 
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I 
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Data  It—  Name :  Message  Type  Data  Item  ID:  MSGTYP 

Data  Item  Description: 

The  message  type  represen ts  the  nature  of  a  given  message. 
It  is  used  for  authorisation  purposes  where  the  type  is 
matched  to  a  specified  path  (source  to  destination).  The 
message  type  is  also  used  to  specify  the  format  of  the 
data  portion  of  the  message. 

Data  Item  Picture:  X(2)  Sise  in  Bytes :  2 

Coding  Type:  Alpha  IDEF1  X  Ref. :  ECS 

Data  Item  Stability:  Statio  Legal  Value  Set  By: 

Message  Source  AP 

where  Used:  Message  Header;  Authority  Table 

Value 

Legal  Values _ Representat i on _ Value  Definition 

See  Appendix  E  for  the  definition  of  Message  Types  within  the 
NTH . 
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Data  Item  Mane:  Humber  of  Mailboxes  Data  I tea  ID:  HUKMBX 


Data  Itea  Description: 

Defines  the  nuaber  of  aailboxes  a  given  AP  will  support. 
An  AP  that  needs  no  input  will  not  support  any  aailboxes. 
AP's  that  aooept  input  will  support  either  one  aailbox  or 
two.  The  second  aailbox  is  used  by  AP's  having  the 
capability  of  receiving  unsolicited  aessages. 

Data  Itea  Pioture:  X  Sise  in  Bytes :  1 

Coding  Type:  Alpha/Muaeric  IDEF1  X  Ref. :  EC17 

Data  Itea  Stabi 1 1 ty :  Static  Legal  Value  Set  By: 

AP  Developer 

Where  Used:  AP  Characteristics  Table 

Value 

Legal  Values _ Representation _ Value  Definition 


No-MBX  0 

One-MBX  1 

Two-MBX  2 


AP  has  no  aailboxes 

AP  supports  one 
aailbox  (and  a 
snail  "ACK"  aailbox) 

AP  supports  two 
mailboxes  and 
is  able  to  receive 
unsolicited  messages 
(the  AP  also 
supports  a  small 
"ACK"  mailbox) 
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Data  Item  Name:  Number  of  Messages  Data  Item  ID:  NUMMSG 

Data  Item  Description: 

This  item  value  provides  the  number  of  messages  in  queue 
waiting  for  a  given  generic  Application  Prooess  (not 
instance). 

Data  Item  Picture:  X(2)  Sise  in  Bytes :  2 

Coding  Type:  Alpha/Numeric  IDEF1  XRgf :  EC  17 

Data  Item  Stabl 1 ity:  Dynamic  Legal  Value  Set  By: 

Looal  MPU 

Where  Used:  AP  Operating  Information  Table 
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Data  I tea  Maae:  Huaber  of  Parents  Data  I tea  ID:  ROPINS 

Per  Instance 

Data  I tea  Description: 

Defines  the  number  of  "Parents"  a  given  AP  instance  aay 
have  at  any  one  tine.  This  itea  distinguishes  between  a 
single  instance  type  of  AP  (one  parent  per  instance)  and  a 
queue  server  type  of  AP  (aultiple  parents  per  instance) . 

In  the  case  of  a  queue  server  this  itea  also  serves  to 
define  the  aaxiaua  number  of  sources  that  can  be  connected 
to  it  at  any  one  tine. 

Data  Item  Picture :  X(2)  Sine  in  Bytes :  2 

Coding  Type:  Alpha/Nuaeric  IDEF1  X  Ref. :  EC17 

Data  Itea  Stability:  Static  Legal  Value  Set  By: 

AP  Developer 

Where  Used:  AP  Characteristics  Table 
Value  Range:  01-99 
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Data  Item  Dame:  Dumber  of  Tries  Data  Item  ID:  KTRIES 

Data  Item  Description: 

Identifies  the  number  of  times  an  entry  in  the  I‘m  Alive 
table  has  been  checked .  After  a  given  number  of  oheoks 
without  receiving  an  I'm  Alive  message  from  the  AP,  it 
must  be  asssumed  that  the  AP  is  in  trouble.  The  MPU  will 
then  take  appropriate  action. 

Data  Item  Picture:  X  Else  in  Bytes :  1 

Coding  Type:  Alpha/Numeric  IDBF1  X  Ref . :  M/A 

Data  Item  Stabi 1 ity :  Dynamic  Legal  Value  Set  By: 

MTM  Developers 

Where  Used:  I'm  Alive  Table 
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Data  I tea  Maae:  On  Abort 


Data  I tea  ID:  ONABT 


Data  I tea  Description: 

This  itea  defines  how  a  given  generic  AP  is  to  be  handled 
when  an  abort  message  arrives  tor  it. 


Data  Itea  Plctnre:  X 

Coding  Type:  Alpha/Muaeric 

Data  Itea  Stability:  Static 
AP  Developer 


Slse  in  Bytes :  1 
IDEF1  XRef :  EC  17 
Legal  Value  Set  By: 


Where  Psed:  AP  Characteristics  Table 
Legal  Values 


Value 

Representat 1 on 


Value  Definition 


Run-Coap 
Send -Abort 

Ab-Tera 


1 

2 


Run  to  coapletion 

Forward  the  abort 
aessage  to  the  AP. 

Abnornally  terninate 
the  AP  via  an  OS 
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Data  Item  Name:  On-Child  Abnormal  Data  Item  ID: 

Termination  ONCLDA 

Data  Item  Description: 

This  item  is  used  to  indicate  whether  a  given  AP  requires 
a  status  message  upon  the  abnormal  termination  (abort)  of 
one  of  its  child  AP's.  It  further  indicates  whether  the 
given  AP  is  to  be  abnormally  terminated  itself  upon  a 
child  abort. 

Data  Item  Picture:  X 


Coding  Type:  Alpha/Numeric 
Data  Item  Stability:  Static 


Where  Used:  AP  Characteristics  Table 

Value 

Legal  Values _ Represen  tat  i  on _ Value  Definition 

No  message  to  AP-HPU 
status  message  only 

AP  wants  child 
abnormal  termination 
message 

Abort  Parent  on 
Child  Abort 


No-Send-Msg  0 

Send-Nsg  1 

Abort  2 


Size  in  Bytes :  1 

IDEF1  XRgf :  EC  17 

Legal  Value  Set  By: 
AP  Developer 
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Data  It»m  Name:  On-Child  Normal 

Termination 


Data  Item  ID:  ONCLDT 


Data  Item  Description: 

This  item  is  used  to  indicate  whether  a  given  AP  requires 
a  status  message  upon  the  normal  termination  of  one  of  its 
child  AP's.  It  further  indicates  whether  the  given  AP 
should  be  terminated  itself  upon  its  child  normal 
termination. 

Data  Item  Picture:  X  Size  in  Bytes :  1 

Coding  Type:  Alpha/Numeric  IDEF1  XRef :  EC  17 

Data  Item  Stability:  Static  Legal  Value  Set  By: 

AP  Developer 

Where  Used:  AP  Characteristics  Table 


Value 

Legal  Values _ Represen  tat  1  on 


Value  Definition 


No-Msg  0  No  message  to  AP-MPU 

only 


Req  Msg  1 

termination 


AP  wants  child 
message 


Ki 1 1 -Parent 


2 


Terminate  Parent 
upon  Child's 
normal  termination 


] 

i 
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Data  Item  Name;  On -Chi Id  Shutdown  Data  Item  ID;  ONCLDS 

Data  Item  Description; 

Indicates  whether  a  given  AP  requires  a  status  message 
upon  the  shutdown  of  one  of  it's  child  AP's.  It  further 
indicates  whether  the  Parent  AP  should  abort  upon  the 
Child  AP  shutdown. 


Data  Item  Picture;  X 
Coding  Type:  Alpha/Numeric 
Data  Item  Stabi 1 ity;  Static 

Where  Used:  AP  Characteristics  Table 

Value 

Legal  Values _ Represen  tat  1  on 


Size  in  Bytes :  1 

IDEF1  XRef :  EC  1? 

Legal  Value  Set  By: 
AP  Developer 


Value  Definition 


Msg-No  0 

Msg-Yes  1 


No  message  to  Parent 
AP 

Parent  AP  wants  a 
message 


Abort-Parent 


2 


Abort  the  Parent  on 
Child  AP  Shutdown 
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Data  Item  gage;  On-Recovery  Data  Item  ID:  ONREC 

Data  Item  Description: 

Indicates  whether  a  given  AP  contains  the  internal  logic 
to  process  startup  in  a  recovery  node  as  well  as  in  an 
initiate  mode. 


Data  Item  Picture:  X 
Coding  Type:  Alpha/Numeric 
Data  Item  Stabi 1 i ty :  Static 

Where  Used:  AP  Characteristics  Table 

Value 

Legal  Values _ Representat i  on 

Can-Handle  1 

own  Recovery 

Can't-Handle  0 


Size  in  Bytes :  1 

IDEF1  XRef :  EC  17 

Legal  Value  Set  By: 
AP  Developer 


Value  Definition 


AP  can  handle  its 


AP  cannot  handle  its 
own  Recovery 
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Data  I  tea  Maae:  On  Shutdown  Data  I  tea  ID;  OHSTDH 

Data  I tea  Description: 

Indicates  whether  the  given  AP  contains  internal  logic  to 
process  a  shutdown  aessage  from  the  NTH. 


Data  I tea  Picture:  X 
Coding  Type:  Alpha/Ruaeric 
Data  I tea  Stability;  Static 

Where  Used:  AP  Characteristics  Table 

Value 

Legal  Values _ Representat i on 

Has -Logic  1 

own  shutdown 

Mo-Logic  0 

Run-to-Coap  2 


Slse  in  Bytes :  1 

IDEF1  XRef :  EC  17 

Legal  Value  Set  By: 
AP  Developer 


Value  Definition 


AP  can  handle  its 


AP  cannot  handle  its 
own  shutdown 

AP  is  shutdown  fron 
a  source  other  than 
the  MPU  -  it  should 
not  be  sent  a 
shutdown  aessage 
nor  should  it  be 
aborted. 
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Data  Item  Name:  Original  Source  AP 


Data  Item  ID:  ORGSRC 


Data  Item  Description: 

The  original  source  of  the  message  that  initiated  the 
"head"  AP  of  a  given  tree  of  AP's.  The  source  is 
identified  by  its  AP  Name,  Instance,  and  resident  AP 
Cluster.  Its  value  representation  is  taken  from  the 
Message  Source  Header  field  of  the  original  message. 


Data  Item  Picture:  X(15) 


Size  in  Bytes:  15 


Coding  Type :  Alpha/ Numeric 
Data  Item  Stability:  Dynamic 


IDEF1  XRef :  EC  42 

Legal  Value  Set  By : 
MPU 


Where  Used :  Message  Header;  AP  Status  Table;  Message  Pairing 
Table 

Represen tat i on : 


Original -Source 
03  Original -Source-AP 

03  Original -Source-Instance 

03  Original-Source-APC 


PICX(IO) . 
PICX( 2) . 
PICX( 3) . 
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Data  I  tea  Haute:  Pair  Flag 


Data  I tea  ID:  PRFLAG 


Data  I tea  Description: 

The  pair  flag  is  set  when  a  given  AP  Instance  has  one  or 
aore  outstanding  waits  on  paired  aessages. 


Data  Itea  Picture:  X 


Coding  Type:  Alpha/Nuaeric 
Data  Itea  Stabi 1 i ty :  Dynamic 


Where  Used:  AP  Status  Table 


Legal  Values 


Value 

Representat 1 on 


Size  in  Bytes :  1 
IDEF1  XRef:  EC  16 


Legal  Value  Set  By: 
Local  MPU 


Value  Definition 


Pair-Set 


1 


Ho-Pair 


0 


AP  Instance  has  one 
or  aore  ou standing 
waits  -  Flag  is  set 

AP  Instance  has  no 
paired  aessages  - 
Flag  not  set 
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Data  I tea  Haae:  Pairing  Requireaent  Data  I tea  ID:  PREQMT 

Data  I tea  Description: 

The  pairing  requireaent  indicates  whether  the  aessage 
conforaing  to  a  given  category  will  require  pairing 
servioes.  These  services  involve  creating  an  entry  into 
the  Message  Pair  Table,  tracking  tiaeouts  on  a  pair,  and 
aatching  the  response  aessage  to  its  request. 

Data  I tea  Picture:  X  Size  in  Bytes :  1 

Coding  Type:  Alpha/Nuaeric  IDEF1  XRef :  EC  36 

Data  I tea  Stability:  Static  Legal  Value  Set  By: 

Message  Category 

Where  Used :  Message  Category  Table 

Value 

Legal  Values _ Represen  tat  i  on _ Value  Definition 

Pair  1  Message  requires 

pairing 

No-Pair  0  Message  does  not 

require  pairing 
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Data  Hem  Name:  Physical  Host  Name  Data  Item  ID:  PHTHST 

Data  Item  Description: 

A  physical  host  machine  is  an  actual  instance  of  a 
computer.  The  physical  host  is  referenced  as  one  or  more 
logical  host(s)  (see  Logical  Host  Name). 

Data  Item  Picture:  X(3)  Sise  in  Bytes :  3 

Coding  Type:  Alpha/Numeric  IDEF1  XRef :  EC  1 

Data  Item  Stability:  Static  Legal  Value  Set  By: 

Host  Vendor 

Where  Psed:  Host  Status  Table 


Value 


Legal  Values 

Representat i on 

Value  Definition 

VAX 

VAX 

VAX  11/780 

IBM 

IBM 

IBM  3033 

HL6 

HL6 

Honeywell  Level  6 

DS  620142000 
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Data  Item  Name :  Processing  Code  Data  Item  ID:  PROCDE 

Data  Item  Description: 

When  a  message  is  accepted  by  an  MPU,  an  accept  message. 
(Message  Manager  ACK-type  MA)  is  sent  to  the  message 
source  AP.  In  the  data  portion  of  this  message,  the 
entire  header  of  the  accepted  message  is  returned.  The  AP 
Interface  may  retain  this  header  for  use  on  future 
identical  messages.  Where  the  header  i6  reused,  the  AP 
Interface  sets  the  Processing  Code  field  value  in  the 
header  to  "1"  (used).  The  MPU  can  then  bypass  the  normal 
data  integrity  checks  on  the  message  header. 

Data  Item  Picture:  X  Sise  in  Bytes :  1 

Coding  Type:  Alpha/Numeric  IDEF1  X  Ref . :  N/A 

Data  Item  Stability:  Dynamic  Legal  Value  Set  By: 

AP  Interface 


Where  Used:  Message  Header 

Value 

Legal  Values _ Representat  1  on _ Value  Definition 

Used  1  Message  header  has 

been  used  previously 
and  is  acceptable 


Message  header  has 
never  been  checked 
by  the  MPU  (default 
value) 


New 


0 
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Data  I tea  Haae:  Pseudo  Instance  Data  I tea  ID;  PIMSTKC 

Data  I tea  Description: 

An  identifier  assigned  to  each  "connection"  of  a  Queue 
Server  AP  requiring  aessage  chaining.  In  effect  this  itea 
identifies  an  instance  within  an  instance  for  those  AP's 
that  deal  with  aultiple  "Parents"  concurrently. 

Data  Itea  Picture:  X  Size  in  Bytes :  1 

Coding  Type:  Alpha/Nuaeric  IDEF1  X  Ref. :  53 

Data  Itea  Stability:  Dynaaic  Legal  Value  Set  By: 

Where  Used:  Connection  Table 


Legal  Values 


Value 

Representation 


Value  Definition 
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Data  I fa  Naae:  Queue  Server  Type 

Data  Item  Description: 

Identifies  the  ohaining  support 

Data  Item  Picture:  X 

Coding  Type:  Alpha/Nuaeric 

Data  I tea  Stability:  Static 


Data  I tea  ID:  A8TYPK 


required  by  the  AP. 

Sise  in  Bytes :  1 

IDEF1  X  Ref. :  17 

Legal  Value  Set  By: 
AP  Developer 


Where  Used:  AP  Inforaation  Table 


Value 

Legal  Values _ Representat  1  on 

No  Chain 

Child-Chain 

Message-Chain 


Value  Definition 


The  AP  requires  no 
chaining  support. 

The  NTH  will  build  a 
child  AP  chain  of 
any  AP's  spawned. 

The  NTH  will  build  a 
■ess age  or 
"connection"  chain 
for  the  AP. 


Note:  Design  not  coapfted  for  Release  2.0. 
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Data  I tea  Maae:  Role  Name 

Data  I tea  Description: 

The  role  naae  identifies  a 
within  the  1XSS.  Each  user 
to  one  or  aore  roles. 

Data  I tea  Picture:  X(10) 

Coding  Type:  Alpha/Muaeric 

Data  I tea  Stability:  Static 

Where  Used:  Logon  Table 


Data  I tea  ID:  ROLENM 

generic  class  of  huaan  users 
on  the  systea  aay  be  assigned 

Size  in  Bytes :  10 

IDEF1  XRef :  EC  12 

Legal  Value  Set  By: 
Subsystem  Developer 
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Data  I tea  Waae:  Session  Start  Tiae  Data  I tea  ID:  STRTME 

Data  I tea  Description: 

The  systea  clock  tiae  when  an  IISS  user's  logon  request 
was  accepted . 

Data  I tea  Picture:  X(23)  Slse  in  Bytes :  23 

Coding  Type:  Alpha/Nuaeric  IDEF1  XRef :  EC  12 

Data  Itea  Stability:  Dynaaic  Legal  Value  Set  By: 

01 

Where  Used:  Logon  Table 
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Data  I tea  Name :  Statistics  Collection  Data  Itea  ID:  STATCO 

Flag 

Data  Itea  Description: 

The  statistics  collection  flag  indicates  whether  certain 
statistical  data  is  to  be  collected  on  the  given  aessage. 

Data  Itea  Picture:  X  Sise  in  Bytes :  1 

Coding  Type:  Alpha/Nuaeric  IDEF1  XRef :  EC  36 

Data  Itea  Stabi 1 i ty :  Static  Legal  Value  Set  By: 

Message  Category 

Where  Psed:  Message  Header;  Message  Category  Table 

Value 

Legal  Values _ Representat  1  on _ Value  Definition 


Col lect 

1 

Collect  statistics 
on  this  aessage 

No-Col lect 

0 

Don't  collect 
statistics  on 
this  aessage 
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Data  Item  Name:  Terminal  ID 

Data  Item  Description: 

A  physical  instance  of 

Data  Item  Picture:  X(2) 

Coding  Type:  Alpha/Numeric 

Data  Item  Stability:  Static 


Data  Item  ID:  TERMID 

computer  terminal  on  the  IISS. 

Size  in  Bytes :  2 

IDEF1  Xgef :  EC  7 

Legal  Value  Set  By: 
UI 


Where  Osed:  Logon  Table 


DS  620142000 
1  November  1985 


Data  Item  gage;  Test  Flag  Data  I tea  ID:  TSTFLG 

Data  I tea  Description: 

This  flag  exists  in  the  aessage  header  to  indicate  whether 
the  source  AP  of  the  given  aessage  is  operating  in  test 
aode.  This  flag  serves  as  a  warning  to  the  destination  AP 
to  process  the  aessage  accordingly  (i.e.,  no  update 
processing  on  a  aessage  with  the  test  flag  set  to  "1”). 


Data  I tea  Picture:  X 
Coding  Type:  Alpha/Nuaeric 
Data  I  tea  Stability.  Dynaaic 

Where  Osed:  Message  Header 

Value 

Legal  Values _ Represen  tat  i  on 

In-Test  1 

No-Test  0 


Size  in  Bytes :  1 

IDEF1  XRef :  EC  19 

Legal  Value  Set  By: 
Source  AP  or  Systea 
Default 


Value  Definition 


Source  AP  is 
operating  in  test 
node 

Source  AP  is 
operating  in 
normal  mode 


a 


•.I 


Data  I tea  Haae:  Tiaeout  Handling 

Data  I tea  Description: 

Identifies  how  a  given  AP  is  to  be 
that  a  tiaeout  on  a  paired  aessage 
reply  aessage  arrives. 

Data  I tea  Picture:  X 

Coding  Type:  Alpha/Nuaeric 

Data  I tea  Stability:  Static 


Where  Used:  AP  Characteristics  Table 


Legal  Values 


No-Can-do-Pairs 


Cancel -Pair 


Abort-on- 

Tineout 


No-Cancel -Pair 


Value 

Represen tat i on 
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Data  Itea  ID:  TMOHDL 

handled  in  the  event 
expires  before  the 

Size  in  Bytes :  1 

IDE FI  X  Ref. :  EC17 

Legal  Value  Set  By: 
AP  Developer 


Value  Definition 


AP  does  not  send 
Paired  Messages 

Delete  entry  in  Pair 
Table 

Abort  AP  when 
tiaeout  expires 
before  reply  arrives 

Set  another  tiaeout 
and  maintain  entry 
in  pair  table 


WWW 
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Data  Item  game:  Time  Stamp  When  Data  Item  ID:  TSMPA 

Accepted 

Data  Item  Description: 

This  item  is  used  in  the  Guaranteed  Delivery  Table  to 
identify  the  time  that  a  GD  message  was  accepted  by  it's 
source  MPU.  The  value  of  this  item  provides  the  base  for 
determining  the  “age"  of  the  message.  The  value  is 
represented  as  system  clock  time,  COBOL  PIC  X(23). 
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Data  Item  Name:  User  Marne 


Data  I tee  ZD:  USRMAM 


Data  I tee  Description: 

The  naee  associated  with  a  given  huean  user  of  the  IISS 
who  is  currently  logged  on  to  the  systee. 


Data  I tee  Picture:  X(8) 
Coding  Type:  Alpha/Nueeric 
Data  I tee  Stability:  Static 

Where  Used:  Logon  Table 


Slse  in  Bytes :  8 

IDEF1  XRef :  EC  12 

Legal  Value  Set  By: 
IISS  Systee 
Adeinistrator 
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APPEMDII  E 
MESSAGE  TYPES 


This  section  defines  the  various  types  of  no s sages  that 
the  MTM  will  be  handling  in  the  IISS  Test  Bed.  Each  type  is 
defined  as  to  its  nature  and  ieplied  processing.  In  addition, 
the  header  values  and  data  portion  oontent  for  each  type  is 
provided. 

Certain  Message  types  have  been  "canned"  to  facilitate 
their  creation  and  delivery,  particularly  when  an  error 
condition  occurs.  These  Messages  are  indicated  by  an  asterisk 
(*). 

Table  E-l  is  an  overview  of  all  of  the  Message  types  in 
teres  of  their  nane,  code  ID.  category,  path,  and  next  iMMediate 
Message  (where  applicable). 

Table  E-2  provides  a  review  of  the  Message  categories 
along  with  relevant  processing  perforaed  by  the  MPU  when  it 
receives  a  Message  confornlng  to  the  given  type. 

The  Message  type  description  are  provided  in  alphabetical 
order  for  ease  of  access. 
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TABLE  E-l 

MESSAGE  TYPE  OVERVIEW 


Type 

Category 

Path 

Next  Msg" 

1. 

Abort  AP 

AB 

C 

" Parent "  MPC-Child  MPO 
Parent  AP  -  Child  MPO 

AP  Dying 

2. 

Active  List 

AA 

F 

MPU  -  Monitor 

(Opt . )0perator 
Abort 

3. 

AP  Already 
Dead 

AM 

G 

MPU  -  Monitor 

M/A 

4. 

AP  Alive 

AL 

G 

AP  -  Local  MPU 

System  State 

5. 

AP  Dying 

AD 

G 

AP  -  Local  MPU 

(Opt . )  Abort 

AP 

6. 

AP  Ending 

AE 

E 

MPU  -  AP 

M/A 

7. 

AP  Init  at  SD 

ML 

G 

MPU  -  Monitor  AP 

M/A 

8. 

AP  Interface 
Error* 

32 

E 

MPU  -  Monitor  AP 

M/A 

9. 

AP  Status 
Request 

SR 

B 

Any  AP  -  Any  MPU 

AP  Status  Return 

10 

.  AP  Status 
Return 

IS 

F 

MPU  -  Requesting  AP 

M/A 

11 

.  APC  Alive* 

LV 

E 

MPU  -  Monitor  AP 

Global  Table 
Update 

12 

.  APC  Avai la¬ 
bility 
Request 

AV 

D 

AP  -  Local  MPU 

APC  Available 
Return 

13 

.  APC  Available  VR 
Return 

F 

Local  MPU  -  AP 

M/A 

E-2 
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TABLE  E-l 

MESSAGE  TYPE  OVERVIEW  (Continued) 


Category 

Path 

"React  Msg" 

14.  A PC  Marne 
Request 

AM 

D 

AP  -  MPU 

APC  Marne  Return 

15.  A PC  Name 
Return 

MA 

F 

MPU  -  AP 

16.  A PC  Status 
Request 

PS 

D 

AP  -  Local  MPU 

APC  Status 

Return 

17.  APC  Status 
Return 

PR 

F 

Local  MPU  -  AP 

M/A 

18.  APC  Termi¬ 
nated 

CT 

E 

MPU  -  Monitor  AP 

H/A 

19.  Cancel  Shut 
down 

CS 

C 

Monitor  AP  -  UI  AP 

M/A  ; 

20.  Change  Role 

21.  Child  AP 
Status 

CD 

E 

Child  APs  MPU  - 
Parent  APs  MPU 

(On  Child  Tree 
Completion) 

Cleanup 

22 .  Get  User 
Request 

UX 

E 

AP-Monitor 

Get  User 

Response 

23.  Get  User 
Response 

XU 

E 

Monitor  -  AP 

M/A 

24.  Cleanup 

CL 

C 

Parent  APs  MPU  - 
Child  APs  MPU 

M/A 

25.  GD  ACK 

GA 

C 

Dest.  MPU  - 
Source  MPU 

M/A 

26.  GD  Status 
Request 

GS 

D 

AP  -  Local  MPU 

GD  Status  Return 

27.  GD  Status 

GR 

F 

Local  MPU  -  AP 

N/A 

E-3 
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Return 


28.  Host 

Active 

HO 

C 

Monitor  AP  - 
Local  MPO's 

M/A 

29.  Host  A- 
vailable 

HA 

E 

Monitor  AP  - 
Monitor  AP 

M/A 

30.  Host  Name 
Request 

KN 

C 

AP  -  Local  MPO 

Host  Name  Return 

E-4 
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TABLE  E-l 

MESSAGE  TYPE  OVERVIEW  (Continued) 


Type 

Category 

Path 

"Mext  Msg" 

SI .  Host  Mane 
Return 

MH 

E 

Local  MP*1  -  AP 

M/A 

32.  Host 

Status 

Request 

HR 

D 

AP  -  Local  MPU 

Host 

Return 

S3.  Host 

Status 

HO 

F 

Local  MPU  -  AP 

M/A 

34.  Host 
Terminating 

HT 

F 

Monitor  AP  - 
Monitor  AP 

Update  Host 
Table 

35.  Initiate 

Conn 

AP 

Cl 

Monitor  AP  -  Conn  AP 

M/A 

36.  Link  Ac¬ 
tive 

LA 

I 

Conn  AP  to 

Monitor  AP 

Host  Alive 

37.  Link  Fail 

LF 

I 

Conn  AP  - 
Monitor  AP 

(Opt . )  Shutdown 
APCs 

38.  List 

Request 

LR 

D 

Monitor  AP  -  MPU 

Active  List 

39 .  Logoff 

OF 

E 

UI  to  Monitor  AP 

H/A 

40 .  Logon 
Request 

LO 

E 

UI  AP  -  Monitor  AP 

Logon  Response 

41 .  Logon 
Response 

LX 

E 

Monitor  AP-UI  AP 

H/A 

42.  Message 
After 
Tineout 

MT 

E 

MPU  -  Monitor  AP 

N/A 

43.  Message 
Mgr. 

ACK* 

MA 

E 

Local  MPU  - 
Msg.  Source  AP 

N/A 

E-5 
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TABLE  E-l 


MESSAGE  TTPE  OVERVIEW  (Continued) 


Type 

Category  Path 

44.  Message 

Mo  Accept* 

34 

E 

Local  MPU  -  Source 
AP 

45.  Message 
for  Un¬ 
available 
APC* 

MQ 

E 

MPU  -  Monitor 

46.  Message 
Reoeive 

ACK 

RA 

F 

AP  -  AP 

47.  Off-Host 
Shutting 
Down 

HS 

C 

Monitor  AP  -  MPU 

48.  Operator 
Abort 

OA 

C 

Monitor  AP  -  MPU 

49.  Paired 
Message 
Status 
Request 

MS 

D 

AP  -  Local  MPU 

50.  Paired 
Message 
Status 
Return 

MR 

F 

Local  MPU  -  AP 

51 .  Process 

Mane  Mot 
Found 

MP 

E 

MPU  -  Monitor  AP 

52.  Proces-* 
sing  Error* 

31 

E 

MPU  -  Monitor  AP 

53.  Rebuild 
Tables 

RT 

D 

Monitor  -  MPU 
Request  Tables 
Rebuilt 

"Mext  Msg" 

M/A 

Queued  Start  APC 
(Operator  Option) 

M/A 

M/A 

AP  Dying  -Or-Proc. 
Mane  Not  Found 

Paired  Message 
Status  Return 

N/A 

M/A 

N/A 

Table  Data 
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TABLE  E-l 

MESSAGE  TYPE  OVERVIEW  (Continued) 


Type 

Category  Path 

"Bext  Msg" 

54 .  Recover¬ 
able  Error 

RE 

E 

AP  -  Monitor  AP 

a/A 

55 .  Resource 
Unavailable* 

33 

E 

MPU  -  Monitor 

M/A 

56 .  Shutdown 

AP 

57 .  Shutdown  AP 
Cluster 

DA 

DC 

C 

D 

Monitor  AP  -  MPU 

MPU  -  MPU 

Monitor  AP  -  MPU 

AP  Dying 

Soft  Shutdown 
(opt . ) 

58 .  Shutdown 

Com  AP 

TR 

E 

Monitor  AP  -  Comm  AP 

AP  Dying 

59 .  Shutdown 

Host 

SH 

B 

Monitor  AP  -  Monitor 

AP  Shutdown 
APC 

60 .  Shutdown 

Link 

SD 

B 

Monitor  AP  -  Con  AP 

M/A 

61 .  Shutdown 
Pending 

SP 

C 

Monitor  AP  -  UI  AP 

M/A 

62.  Signal 

Error 

SE 

E 

MPU  -  AP 

N/A 

63.  Soft 

Shutdown 

SD 

C 

Local  MPU  -  AP 

AP  Dying 

64.  Start  Link 

L 

B 

Monitor  AP  -  Conn  AP 

Link  Active  or 
Link  Fail 

65.  Start  MPU 

SC 

C 

Monitor  AP  - 
Moni tor's  MPU 

M/A 

66.  System  State 

SS 

E 

Local  MPU  -  AP 

M/A 

67.  Table  Data 
Request 

DR 

B 

MPU  -  CDMRP 

Table  Data 
Return 
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TABLE  E-l 


MESSAGE  TYPE  OVERVIEW  (Continued) 


Type 

Category 

Path  “Next  Msg" 

68.  Table  Data 
Return 

DL 

F 

CDMRP  -  MPU 

H/A 

69.  Table  Status 
Request* 

TS 

E 

MPU  -  Monitor  AP 

Table  Status 
Return 

70.  Table  Status 
Return 

ST 

F 

Monitor  AP  -  MPU 

H/A 

71.  Tables 
Rebuilt 

RB 

F 

MPU  -  Monitor 

H/A 

72.  Tineout 
Expired* 

TE 

E 

MPU  -  Local  AP 

H/A 

73.  Unsolicited 

A PC  Terui- 
nat i on 

CE 

F 

MPU  -  Monitor 

Update  APC 
Table 

74.  Unsolicited 
Initiation 
Accept 

IA 

G 

MPU  -  MPU 

H/A 

75 .  Unsuccessful 
Initiation 

HI 

G 

Child  MPU  -  Parent  MPU 

H/A 

76.  Unstable 
Table 

UT 

E 

MPU  -  Monitor 

H/A 

77.  Update  APC 
Table 

UA 

E 

Monitor  AP  -  Monitor  AP 

N/A 

78.  Update  Host  UA 
Table 


E 


Monitor  AP  -  Monitor  AP  N/A 
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TABLE  E-2 

MESSAGE  CATEGORY  REVIEW 


MPU  Special  Processing* 

(Beyond  basic  set  of 

Message  Management 

Category  ID  Category  Definition  Functions) 

A  Guaranteed  Delivery  At  Source 

1.  Checks  Authority 

2.  Creates  Entry  in 
Guaranteed 
Delivery  Table 

5.  Logs  the  Message 

4.  Sends  Accept  Status  to  AP 

5.  Routes  and  Sends  the 
Message 

At  Destination 

1 .  Deteraines  whether 
aessage  requires  AP 
initiation  (and  does  so 
if  required) 

2.  Delivers  Message 

5.  Foraats  and  Sends 

Guaranteed  Delivery 
Accept  aessage  on  receipt 
of  CALL  "GDACK"  froa  AP 

At  Source  Again 

1 .  On  receipt  of  Guaranteed 
Delivery  Accept  Message  - 
deletes  entry  in 
Guaranteed  Delivery  Table 

B  Response  Required  At  Source 

1.  Checks  Authority 

2.  Creates  Entry  in  Pair 
Table 

3.  Logs  Message 

4 .  Routes  and  Sends  Message 

At  Destination 

1 .  Determines  whether 
aessage  requires  AP 
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initiation  (and  does  so 
if  required) 

2.  Delivers  Message 


•MPU  Special  Processing  is  treated  here  in  a  rather  general 
sense.  Details  of  these  functions  are  provided  in  Section  4.2. 


DS  620142000 
1  November  1985 


Category  ID 
C 


D 


TABLE  E-2 

MESSAGE  CATEGORY  REVIEW  (Continued) 


MPU  Special  Processing 
(Beyond  basic  set  of  Message 
Category  ID  Category 
Definition  Management 
Category  Definition  Functions) 


System  Command  -  At  Source 

No  Response  A.  Where  MPO  is  the  source 

1 .  Formats  Message 

2.  Logs  Message 

3.  Routes  and  Sends 
Message 

B.  Where  Monitor  AP  is 
the  Source 

1 .  Logs  Message 

2.  Routes  and  Sends 
Message 


System  Command  - 
Response  Required 


At  Destination 
1 •  Performs  processing  in 
accordance  with 
Message  Type 

At  Source 

1.  Formats  Message 

2.  Creates  Entry  in  Pair 
Table 

3.  Logs  Message 

4.  Routes  and  Sends 
Message 


At  Destination 
1.  Performs  Processing  in 
accordance  with 
Message  Type 

Unsolicited  Message  At  Source 

A.  Where  MPU  is  the 
source 

1 .  Formats  Message 

2.  Logs  Message 

3.  Routes  and  Sends 
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Message 

B.  Where  local  AP  is  the 
Source 

1 .  Logs  Message 

2.  Routes  and  Sends 
Message 

At  Destination 

1 .  Determines  whether 
Message  requires  AP 
Initiation  (and  does 
so,  if  required) 

2.  Delivers  Message 

3.  Sends  Initiation  ACK 
(if  required) 
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TABLE  E-2 

MESSAGE  CATEGORY  REVIEW  (Continued) 


MPU  Special  Processing 
(Beyond  basic  set  of  Message 

Category  ID  Category  Definition  Management  functions) 

F  Solicited  Message  At  Source 

A.  Where  MPU  is  the  source 

1 .  Formats  Message 

2.  Logs  Message 

3.  Routes  and  Sends 
Message 

B.  Where  local  AP  is  the 
Source 

1 .  Logs  Message 

2.  Routes  and  Sends 
Message 

At  Destination 

1 .  Locates  and  deletes  Entry 
in  Pair  Table  (if  entry 
is  still  in  pair  table  - 
if  entry  is  not  found  the 
message  is  discarded  and 
an  MT  message  is 
generated ) 

2.  Delivers  Message  (if 
entry  mas  in  Pair  Table) 

G  AP  Status  Message  At  Source 

(from  Local  AP 

to  its  MPU  R/A 

only) 

At  Destination 

1 .  Updates  AP  Status  Table 

2.  Performs  any  processing 
implied  by  AP's  status 
(e.g..  sending  status 
messages  to  the  AP’s 
Parent,  requesting 
clean-up.  etc.) 
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Initiation  Message  At  lovrot 

1.  Chocks  Authority 

2.  Crontos  Child  Tnblo  Entry 
8.  Logs  Message 

4.  Montes  and  tends  Message 

At  Destination 

1.  Initiates  AM 

2.  Creates  entries  in  AP 
ttatas  Table  and  In 
Aline  Table 
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TABLE  1-2 

MESSAGE  CATEGOKT  REVIEW  (Con tinned) 


Category  ZD  Category  Definition 


MPO  Special  ProoMti&f 
C ■•yond  basic  sot  of  Message 
Managoaont  functions) 


Messages  froa  COMM  At  Souroe 

1.  Logs  Message 

2.  Creates  Eatrv  la  Pair 
Table 

S.  Routes  sad  Beads  Message 


J 


Paired  Specific 
Xaitiatioa 


At  Dost laatioa 
1 •  Dete raises  whether 

■••sage  requires  AP 
iaitiatioa  (aad  does  so 
if  required) 

S.  Delivers  Message 

At  Souroe 
1.  Legs  Message 
S-  Creates  entries  in  Pair 
Table  aad  obi  Id  table 
S.  Routes  aad  Beads  Message 


At  Destination 

1.  Initiates  Mew  AP  Xastaaoe 

2.  Delivers  Message 
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Message  Type:  Abort  AP  Type  ID:  AB 

Mature  of  Message: 

Message  to  an  MPU  informing  it  that  one  of  its  resident 
AP's  is  to  be  abnormally  terminated.  The  MPU  will  handle 
the  actual  abort  via  either  an  OS  call  or  by  sending  this 
message  to  the  APs  that  manage  "Soft  Aborts."  The  MPU's 
handling  of  this  message  is  determined  by  the  given  AP's 
characteristics  in  regard  to  aborts. 


Path:  Parent  MPU  -  Child  MPU 
Parent  AP  -  Child  MPU 


Header  Fields _ Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Mative  Flag 
Priority  Flag 
Message  Type 
AP  Ha me  CDest . ) 
Instanoe  (Dost.) 

A PC  lane  (Dest.) 

AP  Marne  (Source) 
Instance  (Source) 

AFC  Marne  (8ouroe) 
Message  Serial  • 
Processing  Code 
Message  Category 
Priority  of  Souroe  AP 
Integrity  Cheok  Flag 
Logging  Flag 
8tat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Coed. 
Original  Souroe 
Channel  ID 
Continuation  Flag 


A 

092 

0013 

M  (Default) 
1 

AB 

Child  MPU 


AP  Mane  (AP  PIC 
to  be  aborted) 


Channel  ID  PIC 
(of  AP  to 
be  aborted) 


Det  by  SysOen  Parameter 
Child  APC 


Parent  AP-or-Parent  MPU 


Parent  AP  Inst  -  or  -  MPU 


Instanoe 


Local  APC 

Filled  in  by  Source  MPU 
Given  by  Souroe  AP  Int. 
C 


from  AP  Char.  Table 


0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


X(10) 


X(3) 
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Message  Type:  Active  List  Type  ID:  AA 

Mature  of  Message: 

List  of  all  active  APs  on  a  given  AP  Cluster.  Response  to 
List  Request  Message. 


Path:  MPU  -  Monitor 


Header  Fields 

Header  Values 

Data  Fields  Data  Values 

Header  Format 

A 

For  all  Active  APs  on  APC 

Header  Length 

092 

AP  Mane 

PIC  X(10) 

Data  Length 

Variable 

Instance 

PIC  X(2) 

Binary /Native  Flag 

M  (Default) 

On  Abort 

Value  PIC  X 

Priority  Flag 

0 

(fron  AP 

Chare. 

Message  Type 

AA 

Table) 

AP  Marne  (Dest . ) 

Monitor  AP 

Original 

Souroe  PIC  X(15) 

Instance  (Dest . ) 

A PC  Marne  (Dest . ) 

Det  by  SysGen 
Monitors  APC 

Parameter 

AP  Marne  (Souroe) 

Providing  the 

List 

Instanoe  (Source) 

A PC  Marne  (Souroe) 

Det  by  SysGen 
MPU's  APC 

Parameter 

Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 

Filled  in  by  Source  MPU 

0 

F 

0 

0  (Default) 

Logging  Flag 

Stat.  Collection  Flag 

Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tine  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Souroe  AP 
MPU's  Channel 
0 


DS  620142000 
1  Hovenber  1985 


Message  Type:  AP  Alive  Type  ID:  AL 

Mature  of  Message: 

Message  fron  an  initiated  instance  of  an  AP  to  its  local 
MPU  inforaing  it  that  the  AP  is  up  and  ready  to  run.  Upon 
receipt,  the  MPU  will  delete  the  relevant  entry  in  its 
"I 'a  alive  table."  Further,  the  MPU  will  update  the  AP 
Status  Table  entry  for  the  given  AP  Instance. 


Path:  AP  >  Local  MPU 

Header  Fields  _ Header  Values  Data  Fields  Data  Values 


Header  Foraat 
Header  Length 
Data  Length 
Binary/Mat ive  Flag 
Priority  Flag 
Message  Type 
AP  Mane  (Dest . ) 
Instance  (Dest.) 

APC  Mane  (Dest.) 

AP  Mane  (Source) 
Instance  (Source) 

APC  Mane  (Souroe) 
Message  Serial  4 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tine  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  AP  Process  Mane 

092 
0012 

M  (Default) 

0 

AL 

Local  MPU 

Det  by  SysGen  Paraneter 
Local  APC 
Init.  AP 

Assigned  by  MPU  at  Init 
Local  APC 

Filled  in  by  Source  MPU 
Given  by  AP  Int 
G 
0 

0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


PIC  X( 12) 
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Message  Type:  AP  Already  Dead*  Type  ID:  AM 

Mature  of  Message: 

Sent  when  an  MPU  attempts  to  deliver  a  aessage  to  an  AP 
that  has  terainated. 


Path:  MPU  -  Monitor  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Poraat 
Header  Length 
Data  Length 
•inary/Mative  Flag 
Priority  Flag 
Message  Type 
AP  Maae  (Dest.) 
Instanoe  (Dest . ) 

A PC  Maae  (Dest.) 

AP  Maae  (Source) 
Instanoe  (Souroe) 

A PC  Maae  (Souroe) 
Message  Serial  • 
Processing  Code 
Message  Category 
Priority  of  Souroe  AP 
Integrity  Check  Flag 
Logging  Flag 
8tat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tine  Trigger 
Delivery  Trig.  Coad. 
Original  Souroe 
Channel  ID 
Continuation  Flag 


A 

Status  Code 

PIC 

X(5) 

092 

Maae  String 

PIC 

X(7) 

0017 

(Prooess  naae 

H  (Default) 

of  Dead  AP) 

0 

Filler 

PIC 

1(5) 

AM 

Monitor  AP 

Det  by  SysQen  Paraaeter 

Monitors  APC 

Dead  APs  MPU 

Det  by  SysGen  Paraaeter 

Looal  APC 

Filled  in  by  Souroe  MPU 
1 
G 

Fron  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Souroe  AP 
of  Msg.  Souroe  AP 
0 


DS  620142000 
1  November  1985 


Massage  Type:  AP  Dying 


Type  ID:  AD 


Mature  of  Message: 

AP  Status  information  given  to  the  AP's  KPU  when  the  AP  is 
terminating.  The  MPU  will  use  the  data  provided  to  update 
the  local  AP  Status  Table.  The  MPU  will  then  send  a  child 
status  message  to  the  dying  AP's  Parent  MPU. 


Path:  AP  -  MPU 
Header  Fields 


Header  Format 
Header  Length 
Data  Length 
Binary/Hat ive  Flag 
Priority  Flag 
Message  Type 
AP  Marne  (Dest.) 
Instance  (Dest . ) 

A PC  Mane  (Dest . ) 

AP  Marne  (Source) 
Instance  (Source) 

AFC  Marne  (Source) 
Message  Serial  « 
Processing  Code 
Message  Category 
Priority  of  Souroe  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Souroe 
Channel  ID 
Continuation  Flag 


Header  Values  Data  Fields  Data  Values 


A  Termination 

092  Status 

0001 

M  (Default) 

0 
AD 

Tern.  AP's  MPU 
Det  by  SysGen  Parameter 
Local  A PC 
Term.  AP 

Assigned  by  MPU  at  Init 
Local  A PC 

Filled  in  by  Source  MPU 
Given  by  AP  Interface 
G 

From  AP  Char.  Table 
0  (Default) 

1 
1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


PIC  X 

88  Mormal 
Tern. 

88  Shutdown 
Complete 
88  Aborted 
88  Exception 
Condition 


Table 


f-20 


DS  620142000 
1  November  1985 


Message  Type:  AP  Ending  Type  ID:  AE 

Mature  of  Message: 

Message  sent  when  the  AP's  having  the  characteristic  of 
requiring  a  message  on  a  child  AP's  termination. 


Path:  MPU  -  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Mative  Flag 
Priority  Flag 
Message  Type 
AP  Marne  (Dest.) 
Instance  (Dest . ) 

A PC  Marne  (Dest. ) 

AP  Marne  (Source) 
Instance  (Souroe) 

A PC  Marne  (Source) 
Message  Serial  * 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Chech  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A 

Child  Process 

092 

Marne 

PIC 

X(12) 

0016 

Child  Channel 

M  (Default) 

ID 

PIC 

X(3) 

0 

Child 

PIC 

X 

AE 

Termination 

Parent  AP 

Status 

Assigned  by  MPU  at  Init 
Local  A PC 
Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Souroe  MPU 
1 
G 

From  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Souroe  AP 
of  Msg.  Souroe  AP 
0 


DS  620142000 
1  November  1985 


Message  Type:  AP  Interface  Error  (to  Monitor)*  Type  ID:  32 
Mature  of  Message: 

Message  sent  to  the  Monitor  AP  when  the  MPU  discovers 
errors  in  the  message  header  as  formatted  by  the  AP 
Interface.  The  MPU  also  sends  an  AI  message  to  the  Source 
AP  (using  a  different  format  -  See  AP  Interface  Error  -  to 
Souroe  AP). 


Path:  MPU  -  Monitor  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary /Native  Flag 
Priority  Flag 
Message  Type 
AP  Marne  (Dest . ) 
Instance  (Dest . ) 

A PC  Marne  (Dest. ) 

AP  Marne  (Source) 
Instance  (Source) 

APC  Marne  (Source) 
Message  Serial  « 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  AI  Error  Code  PIC  X(5) 

092 

0017  AP  Marne  PIC  X(7) 

M  (Default  -  Native) 

0  Processing  code  PIC  X(5) 

32 

Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
MPU  at  Error  Souroe 
Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 
E 

0  (Default) 

0  (Default  -  Mo) 

1  (Tes) 

1  (Yes) 

0  (Default  -  Mo) 

0  (Default  -  lamed.) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
APC  Marne 
0 


£-22 
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Message  Type:  AP  Interface  Error  (to  Source  AP)*  Type  ID:  32 
Mature  of  Message: 

Sent  to  the  Source  AP  when  the  MPO  discover  aun  error  in 
the  Message  header  header  as  formatted  by  the  AP 
Interface ■ 


Path:  MPO  -  Source  AP 


Header  Fields  Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Mane  (Dest.) 
Instance  (Dest.) 

A PC  Name  (Dest . ) 

AP  Maae  (Source) 
Instance  (Source) 

APC  Maae  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tine  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A 

092 

0102 

M  (Default) 
0 
32 


Error  Code  PIC  X(S) 

Bad  Header  PIC  X(92) 

Processing  code  PIC  X(5) 


Error  Source  AP 
Error  Source  AP  Instance 
Local  APC 
Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 


Filled  in  by  Local  MPU 
1 
E 


From  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default  ) 
blank  (Default) 
blank  (Default) 
Monitor  AP 


APC  Name 


0 


DS  620142000 
1  November  1985 


Message  Type:  AP  Initiating  at  Shutdown*  Type  ID:  ML 

Nature  of  Message: 

Message  informing  the  operator  that  an  AP  is  in  the 
process  of  initiating.  This  message  is  Sent  (if  the  AP 
state  exists)  during  shutdown  procedures  undertaken  upon 
receipt  of  a  shutdown  AP  or  shutdown  A PC  command. 


Path:  MPU  -  Monitor  AP 


Header  Fields  Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest . ) 
Instance  (Dest.) 

A PC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

A PC  Name  (Source) 
Message  Serial  * 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tine  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  Status  Code 

092  Name  String 

0017  (AP  in  Init) 

N  (Default)  Filler 

0 
NL 

Monitor  AF 

Det  by  SysGen  Parameter 
Monitor's  APC 
AP's  MPU 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 
G 

From  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg .  Source  AP 
0 


PIC  X(5) 
PIC  X(7) 

PIC  1(5) 
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Message  Type:  AP  Status  Request  Type  ID:  SR 
Mature  of  Message: 

Request  for  the  current  status  of  a  given  AP.  The  request 
will  cause  a  table  lookup  of  the  given  AP's  A PC  AP  Status 
Table. 


Path:  Any  AP  -  Any  MPO 


Header  Fields _ Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Mative  Flag 
Priority  Flag 
Message  Type 
AP  Marne  (Dest.) 
Instance  (Dest.) 

A PC  Marne  (Dest. ) 

AP  Marne  (Souroe) 
Instance  (Source) 

A PC  Mane  (Source) 
Message  Serial  * 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat .  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tine  Trigger 
Delivery  Trig.  Cond . 
Original  Source 
Channel  ID 
Continuation  Flag 


A  AP  Mane  (for 

002  which  status  is 

0010  required) 

M  (Default) 

0 

SR 

Given  AP’s  MPO 

Det  by  SysQen  Paraneter 

MPO' s  APC 

Calling  AP 

Calling  AP  Inst 

Local  APC 

Filled  in  by  Souroe  MPO 
Given  by  Souroe  AP  Int . 

B 

From  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg .  Source  AP 
Specified  or  Default 
0 


PIC  1(10) 


OS  620142000 
1  Movenber  1985 


Message  Type:  AP  Status  Return  Type  ID:  IS 

Mature  of  Message: 

Return  on  an  AP  Status  Request. 


Path:  MPU  -  Requesting  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Fornat 
Header  Length 
Data  Length 
Binary/Mat i ve  Flag 
Priority  Flag 
Message  Type 
AP  Mane  (Dect . ) 
Instance  (Dest.) 

A PC  Mane  (Dest  ) 

AP  Mans  (Souroe) 
Instance  (Source) 

A PC  Bane  (Souroe) 
Message  Serial  • 
Processing  Code 
Message  Category 
Priority  of  8ource  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tine  Trigger 
Delivery  Trig  Coad 
Original  Source 
Channe 1  I D 
Continuation  Flag 


M 


A 

092 

0011 

(Default) 

0 

IS 


AP  Mane  PIC 

(specified  in 
Status  Request) 

AP  Status  PIC 


Source  of  SR  Message 
Source  Inst  of  SR  Message 
Source  A PC  of  SR  Message 
Given  AP  s  MPU 
Det  by  SysQen  Paraneter 
Local  A PC 


Filled  in  by  Source  MPU 
0 
F 
0 

0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  SR  Msg 
of  SR  Msg 
0 


xuo) 

X 


I 


I 

> 
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Message  Type:  APC  Alive*  Type  ID:  LV 

Mature  of  Message: 

Status  Message  inf ore lug  Monitor  AT  that  the  APC  has 
coapleted  its  start  up  processing  and  is  reedy  to  accept 
■essages.  Upon  receipt,  the  Monitor  AP  will  update  its 
own  APC  status  table  and  send  an  “APC  Table  Update* 
Message  to  its  off~host  siblings. 


Path:  MPU  -  Monitor  AP 


Header  Fields 


Header  Values 


Data  Fields  Data  Fields 


Header  Foraat 
Header  Length 
Data  Length 
Binary/Mative  Flag 
Priority  Flag 
Message  Type 
AP  Mane  (Dest. ) 
Instance  (Dest.) 

APC  Maae  (Dest. ) 

AP  Mane  (Source) 
Instance  (Source) 

APC  Mane  (Souroe) 
Message  Serial  * 
Processing  Code 
Message  Category 
Priority  of  8ource  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat .  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tine  Trigger 
Delivery  Trig.  Cond . 
Original  Source 
Channel  ID 
Continuation  Flag 


A 

092 
0017 

M  (Default) 

0 
LV 

Monitor  AP 
Det  by 
Monitor's  APC 
APC  s  MPU 
Det  by  SysCen 
Local  APC 
Filled  la  by 
1 
B 

(Default) 
(Default) 


Status  Code 


Filler 


PIC  KB) 
PIC  K 12) 


Parnneter 


Pari 


iter 


Source  MPU 


0 

0 


0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg  Source  AP 
of  Msg .  Source  AP 
0 


A 


PIC  E(  3 ) 


iMter  LMfil 
OftU  Lef  tb 
liury/ltiiv*  ria| 
Priority  Flag 
Bmmtmgm  Type 
AP  hai  (Dm!  ) 
lulaaot  (Dwl  ) 

APC  baoo  (Daet  ) 

AP  Baaa  (Scarce) 
iMl—oa  ( Scarce ) 

APC  (Soaroo) 

N«ua|«  Sar  1*1  • 
Process  if  Coda 
daaaafa  Catf  ory 
Priority  of  Soares  AP 
latfrity  Cbock  Fla| 
Loffiaf  fla| 

Stat  Col loct ioa  Plaf 
Tost  Plaf 

Do  1  ivory  Trlffor  Plaf 
Dol ivory  Tlaa  Trlffor 
Do 11 vary  Trif  Cond 
Orlflaal  Sourco 
Channo 1  ID 
Coatiaoatlon  Plaf 


OM 

0003 

■  (Dofaalt) 

1 

AV 

Local  BPO 

Dot  by  lyoOoa  Paraaotar 
Local  APC 
■afoot If  AP 
Asstfned  by  BPO  at  Xait 
Local  APC 

Pi llad  la  by  toaroa  HPO 
Givaa  by  AP  Iatarfaco 

D 

Proa  AP  Cbar.  Tablo 
0  (Dofaclt ) 

1 

1 

0  ( Default ) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Hof.  Source  AP 
of  Hof.  Sourco  AP 
0 
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DS  680143000 
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Imm go  Type:  AFC  Available  Return  Type  ID:  VI 

Itiwe  of  leiMfe: 

Seat  m  tie  reipoaie  io  the  AFC  Availability  Request 
Message. 


Fatb :  Local  MFC  -  AF 


1— «Qr  Fields 


Mesder  Values  Data  Fields  Data  Values 


Reader  Foraat 


A  AFC  Status 


Reader  Length 
Data  Leaf th 
■iaary/Rative  Flag 
Priority  Flag 
Message  Type 
AF  Mast  (Dest. ) 
Xastaaoe  (Dest . ) 

AFC  Maae  (Dest.) 

AF  Isas  (Source) 
Xastaaoe  (Source) 

AFC  Raae  (Souroe) 
Message  Serial  • 
Process inf  Code 
Message  Category 
Priority  of  8ource  AF 
Integrity  Check  Flag 
Logging  Flag 
8tat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tiae  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


083 

0003 

M  (Default) 

0 

VR 

Souroe  of  AV  Message 
Souroe  Xnst  of  AV  Message 
Local  AFC 
Looal  MFD 

Det  by  SysOea  Paraaeter 

Local  AFC 

Filled  in  by  Souroe  MPU 
1 

F 

Froa  AF  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg .  Source  AP 
0 


FXC  X( 3) 

SS  AFC  up 
86  AFC  Mot 
Found 
SS  Tiae 

Out 

(if  AFC 
does  not 
ooae  up 
within 
reasonable 
period  of 
tiae) 


DS  820142000 
1  Movsnbor  1985 


Itoiiaf*  Type:  AFC  Ium  Request 


Type  ID:  AM 


Mature  of  Message: 

Sent  as  a  result  of  an  AP  invoking  the  "WHAT AC"  service. 
The  HPO  will  read  the  AP  Information  Table  to  find  the  APC 
upon  which  the  given  AP  resides. 


Path:  AP  -  Local  MPU 


Header  Pields 


Header  Values  Data  Fields  Data  Values 


Header  Fornat 
Header  Length 
Data  Length 
Binary/Mative  Flag 
Priority  Flag 
Message  Type 
AP  Maae  (Dest.) 
Instance  (Dest.) 

APC  Maae  (Dest.) 

AP  Maae  (Source) 
Instanoe  (Source) 

APC  Maae  (Source) 
Message  Serial  « 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tine  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  AP  Maae 

092 
0010 

M  (Default) 

1 

AM 

Local  MPO 

Det  by  SysGen  Parameter 
Local  APC 
Requesting  AP 
Assigned  by  MPU  at  In it 
Local  APC 

Filled  in  by  Source  MPU 
Given  by  AP  Interface 
D 

From  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


PIC  X(10) 


I 

I 


DS  620142000 
1  Moveober  1965 


Message  Type:  A  PC  Marne  Return  Type  ID:  MA 

Mature  of  Message: 

Sent  in  response  to  the  A PC  Marne  Request  Message.  The 
data  portion  contains  the  name  of  the  A PC  on  which  the 
given  AP  resides.  In  the  event  that  the  given  AP  name  was 
not  found,  the  data  portion  will  contain  a  three  character 
error  code. 


Path:  Local  MPU  -  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Mat ive  Flag 
Priority  Flag 
Message  Type 
AP  Mane  (Dest . ) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Mane  (Source) 
Instance  (Source) 

APC  Mane  (Source) 
Message  Serial  * 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat .  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Ghanne 1  ID 
Continuation  Flag 


A  APC  Mane 

092 

0003 

M  (Default) 

0 

MA 

Source  of  AM  Message 
Source  Inst  of  AM  Message 
Local  APC 
Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 
F 

From  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg .  Source  AP 
0 


PIC  X(3) 


08  080142000 
1  Movenber  1088 


N««ta|f  Type :  AFC  Status  Request  Type  XD:  P8 

l&turc  of  Message: 

Sont  as  a  result  of  an  AP  invoking  the  "AC8TAT"  sorvlco. 
The  data  portion  oontaias  the  ns ns  of  the  AFC  of  intorost 
to  the  call inf  AF. 


Fat*:  AF  -  Local  HPO 


Meador  Fields _ Header  Values  Data  Fields  Data  Values 


Header  Forauit 
Header  Length 
Data  Length 
Binary/Rat ive  Flag 
Priority  Flag 
Message  Type 
AF  Mane  (Dost . ) 
Instance  (Dost.) 

AFC  Mane  (Dost.) 

AF  Mane  (Souroe) 
Instance  (Souroe) 

AFC  Mane  (Source) 
Message  Serial  • 
Processing  Code 
Message  Category 
Priority  of  Source  AF 
Integrity  Check  Flag 
Logging  Flag 
Stat .  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tine  Trigger 
Delivery  Trig.  Cond. 
Original  Souroe 
Channel  ID 
Continuation  Flag 


A  AFC  Mane 

002 

0003 

M  (Default) 

0 

PS 

Local  MFD 

Det  by  SysGen  Paraneter 
Local  AFC 
Requesting  AF 
Assigned  by  MFD  at  Init 
Local  AFC 

Filled  in  by  Souroe  MFD 
Given  by  AF  Interface 
D 

Fron  AF  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Souroe  AP 
0 


FIC  X(3) 


E-32 


1 


r  1MB 


Typt :  AFC  IUUi  Ittin  Type  ID:  Ft 

Nature  Of 

loot  la  response  to  the  AFC  lUtm  request  Tho 

data  portion  contains  11m  current  status  of  the  (Ivon  AFC. 


Path:  AF  -  Local  MFC 

—odor  Flo  Ida _ deader  Values  Data  Fields  Data  V 


deader  Foraat 
deader  UBfib 
Data  Leaf ih 
Biaary/Native  Flaf 
Friorily  Flaf 
Nessafe  Typo 
AF  daae  (Deal ■ ) 
Xastaace  (Deal.) 

AFC  daao  (Deal. ) 

AF  daae  (Souroe) 
laalaaoo  (Source) 

AFC  daae  (Souroo) 
Moaaafo  Serial  • 
Process inf  Code 
Nos safe  Catefory 
Priority  of  Souroo  AP 
Intefrity  Check  Flaf 
Loffiaf  Flaf 
Stat .  Collection  Flaf 
Test  Flaf 

Delivery  Triffer  Flaf 
Delivery  Tiae  Triffer 
Delivery  Trif.  Cood. 
Original  Source 
Channel  ID 
Continuation  Flaf 


A  AFC  Status 

ooa 

0001 

d  (Default) 

0 

FI 

Source  of  PS  Nos safe 
Souroo  last  of  PS  He s safe 

Looal  A PC 
Local  NPO 

Dot  toy  SysGen  Paraaetor 
Looal  AFC 

Filled  in  toy  Souroo  NPO 
1 
F 

Froa  AP  Char.  Tatole 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
tolank  (Default) 
blank  (Default) 
of  Msg .  Souroe  AP 
of  Msg.  Souroe  AP 
0 


PIC  X 
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EX  680142000 
In  ffcw  1865 


M—  — fa  Type :  AFC  Teraiuted'  Type  ZD:  CT 

Iftiere  of  MeuAfe : 

Motif  loot  loo  itel  on  AFC  Am  ooapleted  the  ihutdom 
prooeiiia|  reqvested  by  11m  Monitor  AF. 


Folk:  UFO  -  Monitor  AF 


Moodor  fielde 


Mgador  Velagg  Do  to  Fifldi  Polo  Veleei 


leeder  rorwt 
leader  Leaf th 
Data  Leaf th 
Mi nary /Mat 1 vo  Flaf 
Priority  Flaf 
Ketiafe  Typo 
AF  Maao  (Dost.) 
Iastaaoo  (Dost.) 

AFC  Maao  (Dost.) 

AF  Maao  (Souroo) 
Iastaaoo  (Souroo) 

AFC  Maao  (Souroo) 
Mossafo  Sorlal  • 
Frooossiaf  Codo 
Mossafo  Catofory 
Priority  of  8ourco  AF 
Intofrlty  Check  Flaf 
Loffinf  Flaf 
Stat.  Collection  Flaf 
Test  Flaf 

Delivery  Triffer  Flaf 
Delivery  Tine  Triffer 
Delivery  Trif.  Cond. 
Orifinal  Source 
Channel  ID 
Continuation  Flaf 


A  Status  Code 

088 

0017  Filler 

M  (Default) 

0 

CT 

Monitor  AF 

Dot  by  SysGoa  Paraaeter 
Monitor's  AFC 
Shutdown  AFC's  MPU 
Dot  by  SysOea  Paraaeter 
Local  AFC 

Filled  in  by  Souroo  MPU 
1 
E 
0 

0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msf.  Source  AP 
of  Msf.  Source  AP 
0 


FIC  X(5) 
PIC  X( 12) 


DC  620142000 


1  lOVMbtr  IMS 


MttMf*  Type:  Ouotl  Shutdown  Type  XD:  CS 

Itivrt  of  Niim|«: 

Message  overriding  a  shutdown  in  X  aiautes  not loo.  This 
acii«|a  is  applioable  only  if  tho  shutdown  ponding  is 
still  outstanding .  Oaoo  shutdown  proooduros  hnvo  begun, 
thoy  oannot  bo  stoppod. 


Path:  Monitor  AP  -  OX  AP 


Moador  Fields _ Mosdor  Values  Data  Plolds  Data  Valuos 


Hoador  Poraat 
Moador  Length 
Data  Length 
Blnary/Mative  Flag 
Priority  Flag 
Message  Type 
AP  Maae  (Dost.) 
Instanoe  (Dost. ) 

A PC  Maae  (Dost.) 

AP  MasM  (Souroe) 
Instanoe  (Souroe) 

A PC  Maae  (Souroe) 
Message  Serial  • 
Processing  Code 
Message  Category 
Priority  of  8ource  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tine  Trigger 
Delivery  Trig.  Cond. 
Original  Souroe 
Channel  ID 
Continuation  Flag 


A  M/A 

0B2 

0 

M  (Default) 

1 

CS 

OX  AP 

Assigned  by  MPO  at  Xnit 
01  APC 
Monitor  AP 

Dot  by  SysOen  Paraaeter 
Monitor's  APC 
Filled  in  by  Souroe  MPO 
1 
C 

Froa  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Souroe  AP 
of  Msg.  Source  AP 
0 


06  630143000 
1  Bovwbtr  1065 


Message  Type:  Change  Role  Type  XD:  CR 

Mature  of  Message: 

Allows  a  user  to  change  roles  within  a  given  session.  The 
new  role  aust  be  one  that  the  user  is  authorised  for. 


Path:  01  AP  -  Monitor  AP 


Header  Fields _ Header  Values  Data  Pields  Data  Values 

Header  Foraat 
Header  Length 
Data  Length 
Binary/Hatlve  Flag 
Priority  Flag 
Message  Type 
AP  Maae  (Dest.) 

Instance  (Dest.) 

APC  Usee  (Dest . ) 

AP  Mane  (Souroe) 

Instance  (Souroe) 

APC  Maae  (Souroe) 

Message  Serial  • 

Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat .  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tine  Trigger 
Delivery  Trig.  Cond. 

Original  Source 
Channel  ID 
Continuation  Flag 


A  Terainal  ID  PIC  X(2) 

092 

0020  Oser  Maae  PIC  X(8) 

M  (Default) 

0  Mew  Role  PIC  X(10) 

CR 

Monitor  AP 

Det  by  8ysGen  Paraaeter 
Monitor's  APC 
UI  AP 

Assigned  by  MPO  at  Init 
01  s  APC 

Filled  in  by  Source  MPO 
Given  by  AP  Interface 
E 

Froa  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


E-36 


DS  620142000 
1  Moveaber  1985 


Massage  Type:  Child  AP  Status  Type  ZD:  CA 

Mature  of  Message: 

•  Relevant  status  of  a  child  AP.  The  data  is  sent  to  the 

Parent  AP's  MPU  upon  specified  events.  Upon  receipt  of  the 
eessage.  given  the  child's  status,  the  Parent  AP’s  MPU  nay 
i  send  a  cleanup  sassage  back  to  the  ohild's  MPU. 


Path:  Child  AP's  MPU  -  Parent  AP's  MPU 


Header  Fields 

Header  Values 

Data  Fields 

Data  Values 

Header  Foreat 

A 

Process  Maae 

PIC  X( 12) 

Header  Length 

092 

(of  child) 

Data  Length 

0016 

Binary/Mat ive  Flag 

M  (Default) 

Channel  ID 

PIC  X(3) 

Priority  Flag 

0 

(of  child) 

Message  Type 

CA 

AP  Mane  (Dest . ) 

Parent  MPU 

Child  AP 

PIC  X 

Instance  (Dest.) 

Det  by  SysGen 
Paraaeter 

Status 

88  Abort 

APC  Mane  (Dest.) 

Froa  Dest  AP  Maae 

Aoknovl 

AP  Naae  (Source) 

Child  MPU 

68  Child 

Instance  (Source) 

Det  by  SysGen  Paraaeter 

Moraally 

Terain'd 

APC  Maee  (Source) 

Local  APC 

Message  Serial  4 

Filled  in  by  Source  MPU 

Mo  Active 

Processing  Code 

0 

Children 

Message  Category 

E 

86  Child 

Priority  of  Source  AP 

0 

Shutdown 

Integrity  Check  Flag 

0  (Default) 

in  APC  SD 

Logging  Flag 

1 

88  Child 

Stat.  Collection  Flag 

1 

Shutdown 

Test  Flag 

0  (Default) 

in  AP  SD 

Delivery  Trigger  Flag 

0  (Default) 

88  Child 

Delivery  Tine  Trigger 

blank  (Default) 

Shutdown 

Delivery  Trig.  Cond. 

blank  (Default) 

in  Host  SD 

Original  Source 

of  Msg .  Source 

AP 

88  Child 

Channel  ID 

of  Msg.  Source 

AP 

Initiated 

Continuation  Flag 

0 

88  Noraal 
Terai- 
nat i on 
Active 

Chi ldren 

E-37 


1 


DC  M014S000 
ov^ir  IMS 


HCSMtfC  Type :  Cleanup  Type  ID:  CL 

Mature  of  Message: 

Notification  to  clean  up  tables  and  Messages  for  a  given 
AP.  Sent  Men  all  obi  Id  AP's  below  a  point  bave  temiaated 
with  no  active  children  of  tbeir  own.  Tbe  obi Id  AP  s  HPU 
can  now  delete  tbe  child's  entry  in  tbe  AP  Status  table 


Path:  Parent  AP's  MPO  -  Child  APi  HPU 


Header  Fields 


Header  Values  Data  fields  Data  Values 


Header  Poraat 
Header  Length 
Data  Length 
Binary /Native  Flag 
Priority  Flag 
Message  Type 
AP  Mane  (Dost . ) 
Instance  (Dest.) 

A PC  lane  (Dest.) 

AP  Mane  (Source) 
Instance  (Source) 

A PC  Mane  (Souroe) 
Message  Serial  • 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat .  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tine  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  Process  Bane 

002  (of  obi  Id) 

0018 

N  (Default)  Channel  ID 

1  (of  child) 

CL 

Child  AP  HPU 

Det  by  SysOen  Paraneter 

Child  APC 

Parent  AP  HPU 

Det  by  SysOen  Paraneter 

Local  APC 

Filled  in  by  Souroe  HPU 
0 
C 

Fron  AP  Char .  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


PIC  X(12) 
PIC  1(3) 


I 


14*000 
r  IMS 


Mi»»m  Typt  0D  MX  Typ»  ID  GA 

hivrc  of  Nm»«|« 

Hofciow  1  udf — ■  1  of  Um  foci  Uul  o  MfUft  rfiiftf 
QmtuUoI  Dol  Ivory  «u  reoel red  Mi  prMMiti  hr  »ts 
dost  loot  loo  AT  Spot  r«Mlpt  of  Uli  mu(«  IM  aotrcc 
m  will  c loom  ip  lit  GD  Ukl«  Mi  logi  for  iM  specified 

Mllig* 


Path:  Dost  I  Ml  loo  in  -  Booroo  MPO 


Boeder  Fields _ do  odor  Vo  loos  Polo  Fields  Polo  Vo  loos 


doodor  Poroot 
doodor  Loaf th 
Do  to  Length 
Binary /dot 1 vo  Flog 
Priority  Plof 
Mossofo  Typo 
AP  Boao  (Dost  ) 
Instooco  (Dost . ) 

A  PC  Bom  (Dost.  ) 

AP  Bom  (Souroo) 
Instonco  (Souroo) 

AFC  Bom  (Souroo) 
Message  Soriol  • 
Processing  Code 
Mossofo  Category 
Priority  of  Souroo  AP 
Integrity  Chock  Flog 
Logging  Flog 
Stot .  Collection  Flog 
Test  Flog 

Delivery  Trigger  Flag 
Delivery  Tine  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  CK>  Souroo  APC  PIC  1(3) 

on  <2D  Mossofo  PIC  xm 

0010  Soriol  • 

M  (Default) 

1 

QA 

GD  Souroo  MPtJ 

Dot  by  SyoOea  PoroMtor 

MPO  s  APC 

Dost loot ion  MPO 

Dot  by  SysGea  PoroMtor 

Local  APC 

Filled  in  by  Source  MPO 
0 
C 
0 

0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


DS  620142000 
1  November  1985 


Nmb«|«  Type:  Get  User  Response  Type  ID:  UX 

Net arc  of  Message: 

Sent  in  response  to  a  Get  User  Request.  The  eonitor  AP 
will  use  the  original  source  AP  to  access  the  Logon  Table 
for  the  data  values  to  be  sent  back  to  the  requesting  AP. 
The  status  field  indicates  success  or  failure  of  the  table 

search . 


Path.  Monitor  Requesting  AP 


leader  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary /Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 

AFC  Name  (Dest. ) 

AP  Name  (Source) 
Instance  (Source) 

A PC  Name  (Source) 
Message  Serial  t 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat .  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A 

092 

0021 

N  (Default) 
0 
OX 


Status 
User  Name 
Role  Name 
Terminal  ID 


Source  of  Request 
Det  by  SysGen  Parameter 
Request  Source  APC 
VAX  Monitor 

Det  by  SysGen  Parameter 
Monitor's  APC 
Filled  in  by  Source  MPU 
1 
E 


From  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
XGU 
0 


PIC  X 
PIC  X(8) 
PIC  X(10) 
PIC  X(2) 


E-40 


■ 


i  i  t  >  >  >  ■  *■ 


3/3 


tO-UK  ISC 
UNCLASSIFIED 


INTEGRATED  INFORMATION  SUPPORT  SVSTEM  CIISS)  VOLUME  C 
NETWORK  TRANSACTION.  .  <U>  GENERAL  ELECTRIC  CO 
SCHENECTADV  NV  PRODUCTION  RESOURCES  COHSU.  . 

J  CROSS  ET  AL.  II  NOV  S3  DS-62I142MG 


F/G  12/3 


DS  620142000 
1  Moveaber  1985 


Message  Type:  Get  User  Request  Type  ID:  XU 

Mature  of  Message:  _ 

Request  froa  AP  (via  GETUSR  service)  for  the  Oser  Maae. 
Role  Maae,  and  Terainal  ID  of  the  AP's  original  source 
where  the  original  source  is  a  User  Interface  AP. 


Path:  AP  Monitor 


Header  Fields _ Header  Values  Data  Fields  Data  Values 


Header  Foraat 
Header  Length 
Data  Length 
Binary /Mative  Flag 
Priority  Flag 
Message  Type 
AP  Maae  (Dest . ) 
Instance  (Dest.) 

A PC  Maae  (Dest . ) 

AP  Maae  (Source) 
Instance  (Source) 

APC  Maae  (Source) 
Message  Serial  « 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tiae  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  Original 

092  Source  of 

0015  Requesting  AP 

M  (Default) 

0 

XU 

VAX  Monitor 

Det  by  SysGen  Paraaeter 
Monitor's  APC 
Requesting  AP 
Det  by  SysGen  Paraaeter 
Requesting  AP's  APC 
Filled  in  by  Source  MPU 
1 
E 

Froa  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
XGU 
0 


PIC  X( 15) 


E-41 


DS  620142000 
1  November  1985 


Message  Type:  GD  Status  Request  Type  ID:  GS 

Mature  of  Message: 

Sent  as  a  result  of  an  AP  invoking  the  "GDSTAT“  service. 
The  data  portion  contains  the  source  and  serial  number  of 
the  Guaranteed  Delivery  Message  of  interest  to  the  calling 
AP. 


Path:  AP  -  Local  MPU 


Header  Fields  Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest . ) 
Instance  (Dest.) 

APC  Mane  (Dest.) 

AP  Mane  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  « 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat .  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tine  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A 
092 
0017 

M  (Default) 

1 

GS 

Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 
Requesting  AP 
Assigned  by  MPU  at  Init 
Local  APC 

Filled  in  by  Source  MPU 
Given  by  AP  Interface 
D 

Froa  AP  Char.  Table. 
O(Default) 


GD  Message 
Souroe  AP  Naae  PIC 
GD  Message 
Serial  Number  PIC 


1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


X(10) 

X(7) 


E-42 


DS  620142000 
•  1  November  1985 


Message  Type:  GD  Status  Return  Type  ID:  GR 

Nature  of  Message: 

Sent  in  response  to  a  GD  Status  Request.  The  data  portion 
contains  the  current  status  of  the  Guaranteed  Delivery 
Messages  specified  in  the  request. 


Path:  Local  MPO  -  AP 


Header  Fields _ Header  Values  Data  Fields  Data  Values 


Header  Format  A  Return  Code 

Header  Length  092 


Data  Length  0003 

Binary/Native  Flag  N  (Default) 


Priority  Flag 
Message  Type 
AP  Name  (Dest . ) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  • 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


0 

GR 

Source  of  OS  Message 
Souroe  Inst  of  GS  Message 
Local  APC 
Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 
F 

From  AP  Char.  Table. 

0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


PIC  X(3) 

88 

GD-Message 

-in-system 

88 

GD-Message 
-Not -Found 


E-43 


DS  620142000 
1  Noveaber  1985 


Message  Type:  Host  Active  Type  ID:  HD 

Mature  of  Message: 

Message  sent  to  all  on-host  APC's  to  infora  then  that  the 
host  has  coapleted  its  startup  processing. 


Path:  Monitor  AP  -  MPU 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Foraat 
Header  Length 
Data  Length 
Binary /Native  Flag 
Priority  Flag 
Message  Type 
AP  Naae  (Dest . ) 
Instance  (Dest.) 

A PC  Maae  (Dest.) 

AP  Maae  (Source) 
Instance  (Source) 

APC  Naae  (Source) 
Message  Serial  « 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tine  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  N/A 

092 
0000 

M  (Default  -  Native) 

1 

HD 

MPU  Naae 

Det  by  SysGen  Paraaeter 
MPU 's  APC 
Monitor  AP 

Det  by  SysGen  Paraaeter 
Monitor's  APC 
Filled  in  by  Source  MPU 
1 
C 

0  (Default) 

0  (Default) 

1  (Yes) 

1  (Yes) 

0  (Default  -  No) 

0  (Default  -  Inaed) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


DS  620142000 
1  November  1985 


Message  Type:  Host  Available  Type  ID:  HA 

Mature  of  Message: 

Message  sent  at  startup  to  inform  off -host  Monitor  APs 
that  a  given  host  has  completed  its  startup  processing  and 
is  now  available  to  reoeive  messages. 


Path:  Monitor  AP  -  Monitor  AP 


Header  Fields _  Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest . ) 
Instance  (Dest.) 

APC  Marne  (Dest.) 

AP  Marne  (Source) 
Instance  (Source) 

APC  Marne  (Source) 
Message  Serial  * 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Chech  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  For  each  on-host  APC 

092 

Variable  APC  Marne  PIC  X(3) 

M  (Default  -  Native)  APC  Status  PIC  X 
0 
HA 

Off-host  Monitor  AP 
Det  by  SysGen  Parameter 
Monitor's  APC 
On-Host  Monitor  AP 
Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 
E 

0  (Default) 

0  (Default  -  Mo) 

1  (Yes) 

1  (Yes) 

0  (Default  -  Mo) 

0  (Default  -  lamed) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


DS  620142000 
1  November  1985 


Message  Type:  Host  Name  Request  Type  ID:  HM 

Mature  of  Message:  _ 

Sent  as  a  result  of  an  AP  invoking  the  "WHTHST"  Service. 
The  data  portion  contains  the  name  of  the  AP  whose  host 
name  is  being  requested. 


Path:  AP  -  Local  MPU 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Mative  Flag 
Priority  Flag 
Message  Type 
AP  Mane  (Dest.) 
Instance  (Dest.) 

APC  Marne  (Dost.) 

AP  Marne  (Souroe) 
Instance  (Source) 

APC  Marne  (Source) 
Message  Serial  * 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  AP  Marne 

092 

0010 

M  (Default) 

1 

KM 

Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 
Requesting  AP 
Assigned  by  MPU  at  Init 
Local  APC 

Filled  in  by  Souroe  MPU 
Given  by  AP  Interface 
C 

From  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


PIC  X(10) 


DS  020142000 
1  Moveaber  1085 


Message  Type:  Host  Maae  Return  Type  ID:  HH 

Mature  of  Message: 

Sent  In  response  to  a  Host  Maae  Request  Message.  The  data 
portion  contains  the  naae  of  the  Host  associated  with  the 
given  AP. 


Path:  Local  MP0  -  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Foraat 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Maae  (Dost . ) 
Instanoe  (Dost.) 

A PC  Maae  (Dest . ) 

AP  Maae  (Source) 
Instance  (Source) 

A PC  Maae  (Source) 
Message  Serial  « 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Cheok  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tiae  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  Host  Maae 

092  AP  Maae 

0013 

N  (Default) 

0 

MH 

Souroe  of  HH  Message 
Source  Inst  of  HH  Message 
Local  APC 
Local  MPO 

Det  by  SysGen  Paraaeter 
Local  APC 

Filled  in  by  Source  MPO 
1 
E 

Froa  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


PIC  X(3) 
PIC  X(10) 


* 
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Message  Type:  Host  Status  Request  Type  ID:  HR 

Mature  of  Message: 

Sent  as  a  result  of  an  AP  invoking  the  " HSTATS "  service. 
The  data  portion  contains  the  nane  of  the  host  whose 
status  is  of  interest  to  the  calling  AP. 


Path:  AP  -  Local  MPU 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Fornat 
Header  Length 
Data  Length 
Binary/Mative  Flag 
Priority  Flag 
Message  Type 
AP  Mane  (Dest.) 
Instance  (Dest.) 

A PC  Mane  (Dest . ) 

AP  Mane  (Source) 
Instance  (Source) 

APC  Mane  (Source) 
Message  Serial  * 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tine  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  Host  Mane 

092 
0003 

N  (Default) 

1 

HR 

Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 
Requesting  AP 
Assigned  by  MPU  at  Init 
Local  APC 

Filled  in  by  Source  MPU 
Given  by  AP  Interface 
D 

Fron  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


PIC  X(3) 


j 


I 
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1  Moveaber  1985 


Message  Type:  Host  Status  Return  Type  ID:  HO 

Mature  of  Message: 

Sent  in  response  to  a  Host  Status  Request  aessage.  The 
data  portion  contains  the  current  status  of  the  Host  naaed 
in  the  Host  Status  Request. 


Path:  Local  MPU  -  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Foraat 
Header  Length 
Data  Length 
Binary/Mative  Flag 
Priority  Flag 
Message  Type 
AP  Maae  (Dest . ) 
Instance  (Dest.) 

A PC  Maae  (Dest . ) 

AP  Maae  (Source) 
Instance  (Source) 

APC  Maae  (Source) 
Message  Serial  • 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tiae  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  Host  Status 

092  Host  Maae 

0004 

M  (Default) 

0 

HO 

Source  of  HR  Message 
Souroe  Inst  of  HR  Message 
Local  APC 
Local  MPU 

Det  by  SysGen  Paraaeter 
Local  APC 

Filled  in  by  Source  MPU 
1 
F 

From  AP  Char .  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


PIC  X 
PIC  X(3) 


E-49 
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1  Moveaber  1985 


Message  Type:  Host  Terainating  Type  ID:  HT 

Mature  of  Message: 

Message  sent  when  a  Mon-VAX  host  shuts  down. 

Path:  Monitor  AP  -  Monitor  AP 


Header  Fields _ Header  Values  Data  Fields  Data  Values 


Header  Foraat 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Naae  (Dest . ) 
Instance  (Dest.) 

A PC  Maae  (Dest . ) 

AP  Maae  (Source) 
Instance  (Source) 

APC  Maae  (Source) 
Message  Serial  « 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  M/A 

092 
0 

N  (Default) 

0 

HT 

VAX  Monitor  AP 
Det  by  SysGen  Paraaeter 
VAX  Monitor  APC 
Non- VAX  Monitor  AP 
Det  by  SysGen  Paraaeter 
Non-VAX  Monitor  APC 
Filled  in  by  Source  MPU 
1 
F 

Froa  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
Monitor  AP  Channel 
0 


DS  620142000 
1  November  1985 


Message  Type:  Initiate  COMM  AP  Type  ID:  Cl 

Mature  of  Message: 

Message  requesting  the  initiation  of  a  given  COMM  AP. 
Path:  Monitor  AP  -  COMM  AP 


Header  Fields  Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary /Native  Flag 
Priority  Flag 
Message  Type 
AP  Marne  (Dest . ) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Mane  (Source) 
Message  Serial  « 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
..tegrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  N/A 

092 
0 

N  (Default  -  Native) 

1 

Cl 

COMM  AP 

Det  by  SysGen  Parameter 
COMM  APC 
Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
Filled  in  by  Source  MP0 
1 
H 

0  (Default) 

0  (Default  -  No) 

1  (Yes) 

1  (Yes) 

0  (Default  -  No) 

0  (Default  -  Immed) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
COMM  AP  Channel 
0 


DS  620142000 
1  November  1985 


Message  Type:  Link  Active  Type  ID:  LA 

Nature  of  Message: 

Message  from  a  COMM  AP  reporting  the  successful 
establishment  of  a  link  to  its  off -host  sibling.  Upon 
receipt.  Monitor  AP  will  update  the  link  status  table  and 
send  a  "Host  Available"  message  to  the  off-host  monitor  at 
the  other  end  of  the  link. 


Path:  COMM  AP  to  Monitor  AP 

Header  Fields  Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
B inary /Nat ive  Flag 
Priority  Flag 
Message  Type 
Name  (Dest . ) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  ♦ 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  N/A 

092  Specific  Link  is 

0  implied  by 

N  (Default)  COMM  AP  Name 

0 
LA 

Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
COMM  AP 

Det  by  SysGen  Parameter 
COMM's  APC 

Filled  in  by  Source  MPU 
1 
I 
0 

0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 

Of  Msg  Source  AP 
COMM  AP  Channel 
0 


DS  620142000 
1  November  1985 


Message  Type:  Link  Fall  Type  ID:  LF 

Mature  of  Message: 

Message  from  COMM  AP  informing  Monitor  that  a  formerly 
active  link  has  gone  down.  This  message  type  is  also  used 
as  a  return  on  a  “Start  Link”  message. 


Path:  GOMM  AP  -  Monitor  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Mat ive  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest . ) 
Instance  (Dest . ) 

APC  Marne  (Dest.) 

AP  Marne  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  * 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  M/A  -  The  Link 

092  in  question  is 

0  implied  by  the 

M  (Default)  name  of  the 

0  Source  COMM  AP 

LF 

Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
COMM  AP 

Det  by  SysGen  Parameter 
COMM' s  APC 

Filled  in  by  Source  MPU 
1 
I 
0 

0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 

Of  Msg  Source  AP 
COMM  AP  Channel 
0 


DS  620142000 
1  November  1985 


Message  Type:  List  Request 


Type  ID:  LR 


Nature  of  Message: 

Request  froa  IISS  Operator  (via  Monitor)  for  a  list  of  all 
active  APs  on  a  specified  AP  Cluster. 


Path:  Monitor  AP  -  MPU 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Foraat 
Length 
Data  Length 
Binary/Rat ive  Flag 
Priority  Flag 
Message  Type 
AP  Maae  (Dest . ) 
Instance  (Dest.) 

APC  Maae  (Dest.) 

AP  Maae  (Source) 
Instance  (Souroe) 

APC  Maae  (Source) 
Message  Serial  • 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tiae  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  N/A 

092 
0 

N  (Default) 

1 

LR 

Specified  APC  MPU 
Det  by  SysGen  Paraaeter 
Specified  APC 
Monitor  AP 

Det  by  SysGen  Paraaeter 
Monitor's  APC 
Filled  in  by  Source  MPU 
1 
D 

Froa  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
APC's  Channel 
0 


Header 
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Message  Type:  Logoff 


Type  ID:  OF 


Mature  of  Message: 

Notification  froa  UI  that  a  given  user  has  logged  off  the 
IISS  Systea.  Upon  reoeipt  of  this  Message,  Monitor  AP  will 
delete  the  relevant  entry  in  the  Logon  Table. 


Path:  UI  to  Monitor  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Foraat 
Header  Length 
Data  Length 
Binary/Hative  Flag 
Priority  Flag 
Message  Type 
AP  Maae  (Dest . ) 
Instance  (Dest.) 

APC  Maae  (Dest.) 

AP  Maae  (Source) 
Instance  (Source) 

APC  Maae  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tiae  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  UI  (AP)  Hi 

092  UI  APC  Mai 

0015  Terainal  : 

M  (Default) 

0 

OF 

Monitor  AP 

Det  by  SysGen  Paraaeter 
Monitor's  APC 
UI  AP 

Assigned  by  MPU  at  AP  Init 
UI's  APC 

Filled  in  by  Source  MPU 
Given  by  AP  Int 
E 
0 

0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


UI  (AP)  Maae  PIC  X(10) 
UI  APC  Maae  PIC  X(3) 

Terainal  ID  PIC  X(2) 
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Message  Type:  Logon  Request  Type  ID:  LO 

Mature  of  Message: 

Message  from  a  UI  AP  informing  Monitor  AP  of  a  successful 
Logon.  Upon  receipt  of  this  message.  Monitor  will 
transfer  the  data  portion  to  the  Logon  Table. 


Path:  UI  AP  -  Monitor  AP 


Header  Fields 


Header  Values 


Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary /Native  Flag 
Priority  Flag 
Message  Type 
AP  Marne  (Dest . ) 
Instance  (Dest.) 

APC  Marne  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  * 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  UI  (AP)  Name  PIC  X(10) 

092  UI  APC  Name  PIC  X(3) 

0062  Terminal  ID  PIC  X(2) 

N  (Default)  User  Marne  PIC  X(8) 

0  Role  Marne  PIC  X(10) 

LO  Session  Start  PIC  X(23) 

Monitor  AP  Time 

Det  by  SysGen  Channel  Range  PIC  X(3) 

Parameter  Start 

Monitor's  APC 

UI  AP  Channel  Range  PIC  X(3) 

Assigned  by  MPU  at  AP  Init  End 
UI ' s  APC 

Filled  in  by  Source  MPU 
Given  by  AP  Int 
E 
0 

0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


DS  620142000 
1  Hoveaber  1985 


Message  Type:  Message  After  Tiaeout  Type  ID:  MT 

Mature  of  Message: 

Message  to  Monitor  that  a  reply  aessage  on  a  given  aessage 
pair  arrived  after  tiaeout  had  expired. 


Path:  MPU  -  Monitor  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Foraat 
Header  Length 
Data  Length 
Binary/Mative  Flag 
Priority  Flag 
Message  Type 
AP  Maae  (Dest . ) 
Instance  (Dest.) 

APC  Maae  (Dest.) 

AP  Maae  (Source) 
Instance  (Source) 

APC  Maae  (Source) 
Message  Serial  * 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tiae  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  Header  of  Tardy 

092  Message 

0092 

N  (Default) 

0 

MT 

Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
Pair  Request  Souroe  MPU 
Det  by  SysGen  Paraaeter 
Local  APC 

Filled  in  by  Source  MPU 
0 
E 
0 

0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


PIC  X(92) 
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Message  Type:  Logon  Response  Type  ID:  LX 

Mature  of  Message: 

Sent  to  inf ora  the  UI  of  the  status  of  the  IXX90M  Table 
upon  completion  of  processing  the  Logon  Message. 


Path:  Monitor  AP  -  UI 


Header  Fields  Header  Values _ Data  Fields  Data  Values 


Log 

Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Hue  (Dest .  ) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  * 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channe 1  ID 
Continuation  Flag 


A  Table  Status  PIC  X 

092  88  Entry-Made  Value  ”1" 

0001  88  Table-Full  Value  a0" 

N  (Default) 

1 

LX 

Source  of  Logon  Message 
Det  by  SysGen  Parameter 
Logon  Souroe  APC 
VAX  Monitor  AP 
Det  by  SysGen  Parameter 
Monitor  AP's  APC 
Filled  in  by  Source  MPU 
1 
E 

From  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
UIV 
0 


E-58 
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Message  Type:  Message  Manager  ACK*  Type  ID:  MA 

Mature  of  Message: 

Acknow 1 edgeaen t  froa  the  MPU  that  the  message  froa  the 
souroe  AP  was  found  to  be  acceptable.  The  entire  header 
froa  the  accepted  aessage  is  returned  to  be  used  later  by 
the  source  AP. 


Path:  Local  MPU  -  Msg.  Source  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Foraat 
Header  Length 
Data  Length 
Binary/Mat ive  Flag 
Priority  Flag 
Message  Type 
AP  Mane  (Dest . ) 
Instance  (Dest.) 

A PC  Mane  (Dest. ) 

AP  Maae  (Souroe) 
Instance  (Source) 

A PC  Maae  (Source) 
Message  Serial  « 
Processing  Code 
essage  Category 
Priority  of  Souroe  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tine  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  Entire  header  PIC  X(92) 

092  of  Aooepted 

0092  Message 

M  (Default) 

0 

MA 

Source  AP 

Assigned  by  MPU  at  AP  Init 
Souroe  AP's  A PC 
Local  MPU 

Det  by  SysGen  Paraaeter 
Local  A PC 

Filled  in  by  Souroe  MPU 
1 
E 
0 

0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


DS  620142000 
1  Moveaber  1985 


Message  Type:  Message  Mo  Accept*  Type  ID:  ME 

Mature  of  Message: 

Notification  that  a  given  Message  cannot  be  accepted . 
Message  is  logged  and  thrown  away.  The  Message  souroe  is 
inforaed  of  the  problea  via  the  error  code  paraaeter.  In 
certain  cases,  the  Monitor  AP  will  also  be  inforaed  of  the 
problea. 


Path:  Local  MPU  -  Source  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Foraat 
Header  Length 
Data  Length 
Binary/Hat ive  Flag 
Priority  Flag 
Message  Type 
AP  Maae  (Dest . ) 
Instance  (Dest.) 

APC  Maae  (Dest.) 

AP  Maae  (Source) 
Instance  (Source) 

APC  Maae  (Source) 
Message  Serial  * 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat .  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tine  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A 

092 

0097 

N  (Default) 
0 
ME 


Message  Error  PIC  X(5) 

Code 

Entire  Original  PIC  X  (92) 
Header 


Source  AP  of  MACK'S  Msg 
Assigned  by  MPU  at  AP  Init 
Source  AP's  APC 


Local  MPU 


Det  by  SysGen  Paraaeter 
Local  APC 


Filled  in  by  Source  MPU 
1 
E 


Froa  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


DS  620142000 
1  Movenber  1985 


Message  Type:  Message  Queued  for  Type  ID:  MQ 

Unavailable  APC* 

Mature  of  Message: 

Message  informing  the  Operator  that  a  nessage  is  being 
held  for  an  AP  residing  on  a  currently  unavailable  APC. 
The  operator  nay  choose  to  start  the  APC. 


Path:  MPU  -  Monitor  AP 


Header  Fi elds 


Header  Values  Data  Fields  Data  Values 


Header  Fornat 
Header  Length 
Data  Length 
Binary/Mative  Flag 
Priority  Flag 
Message  Type 
AP  Mane  (Dest . ) 
Instance  (Dest.) 

APC  Mane  (Dest. ) 

AP  Mane  (Source) 
Instance  (Source) 

APC  Mane  (Source) 
Message  Serial  * 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat .  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tine  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A 

092 

0017 

M  (Default) 
0 
MQ 


Status  Code 
Mane  String 
Processing 
Code 


Monitor  AP 

Det  by  SysGen  Paraneter 
Monitor's  APC 
Msg .  Souroe  MPU 
Det  by  SysGen  Paraneter 
Msg .  Source  APC 
Filled  in  by  Source  MPU 
1 
E 


Fron  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


PIC  X(5) 
PIC  X(7) 
PIC  X(5) 
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Message  Type:  Message  Receive  ACK  Type  ID:  RA 

Mature  of  Message: 

Sent  to  acknowledge  the  receipt  of  a  message  by  the 
message's  destination  AP.  Mote:  This  message  type  may  be 
used  to  acknowledge  those  requiring  Guaranteed  Delivery 
Services . 


Path:  AP  -  AP 


Header  Fields _ Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Marne  (Dest . ) 
Instance  (Dest.) 

APC  Marne  (Dest.) 

AP  Marne  (Source) 
Instance  (Source) 

APC  Marne  (Source) 
Message  Serial  * 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A 

092 

0010 

M  (Default) 
0 
RA 


APC  Name  (from 
Rec'd  Msg) 

Msg  Serial  «  PIC 
(from  Rec'd  Msg) 


Ack'd  Msg  Source  AP 
Ack'd  Msg  Source  Instance 
Ack'd  Msg  Source  APC 
Receiving  AP 

Assigned  by  MPU  at  AP  Init 
Local  APC 

Filled  in  by  Source  MPU 
Given  by  AP  Interface 
F 


From  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
from  Rec'd  Msg 
from  Rec'd  Msg 
0 


PIC  X(3) 
X(7) 


DS  620142000 
1  November  1985 


Message  Type:  Off-Host  Shutting  Down  Type  ZD:  HS 

Mature  of  Message: 

Message  froa  Monitor  to  its  on-host  APC's  to  infora  thea 
of  an  off-host  shutdown.  The  APC  MPU's  can  then  take 
appropriate  action  as  required  (e.g.,  not  trying  to  route 
and  send  a  aessage  to  the  shutdown  host). 


Path:  Monitor  AP  -  MPU 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Foraat 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Naae  (Dest . ) 
Instance  (Dest.) 

APC  Maae  (Dest.) 

AP  Naae  (Source) 
Instance  (Source) 

APC  Maae  (Source) 
Message  Serial  * 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tiae  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  Host  Maae  (of  PIC  X(3) 

092  host  shutting 

0003  down) 

M  (Default  -  Native) 

1 

HS 

On-Host  APC  MPU 
Det  by  SysGen  Paraaeter 
Dest.  MPU's  APC 
Monitor  AP 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 
C 

0  (Default) 

0  (Default  -  No) 

1  (Yes) 

1  (Yes) 

0  (Default  -  No) 

0  (Default  -  lamed) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


E-63 


DS  620142000 
1  Hoveaber  1985 


Message  Type:  Operator  Abort  Type  ID:  OA 

Nature  of  Message: 

Coaaand  froa  the  Operator  telling  the  MPU  to  abort  a 
specific  instance  of  an  AP-  The  MPU  will  handle  the  abort 
in  the  Banner  specified  for  "Abort  AP." 


Path:  Monitor  AP  -  MPU 


Header  Fields _ Header  Values  Data  Fields  Data  Values 


Header  Foraat 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Naae  (Dest . ) 
Instance  (Dest.) 

A PC  Naae  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Naae  (Source) 
Message  Serial  « 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Chech  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A 

092 

0012 

N  (Default) 

1 

OA 

"Aborting"  AP's 


AP  Naae  (of  AP 
to  be  aborted) 

Instance  (known 
to  Operator 
froa  Active  List) 
MPU 


Det  by  SysGen 
MPU's  APC 


Paraaeter 


Monitor  AP 

Det  by  SysGen  Paraaeter 
Local  APC 

Filled  in  by  Souroe  MPU 
1 
C 

Froa  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


PIC  X(10) 
PIC  X(2) 


DS  620142000 
1  November  1985 


Message  Type:  Paired  Message  Status  Request  Type  ID:  MS 
Mature  of  Message: 

Sent  as  a  result  of  an  AP  invoking  the  "PRSTAT"  Service. 
The  data  portion  contains  the  parameters  given  in  the 
call . 


Path:  AP  -  Local  MPU 


Header  Fields 

Header  Values 

Data  Fields  Data 

.  Values 

Header  Format 

A 

Paired  Message 

PIC 

X(10) 

Header  Length 

092 

Destination 

Data  Length 

0013 

AP  Mane 

Binary/Native  Flag 

M  (Default) 

Paired  Message 

PIC 

X(3) 

Priority  Flag 

1 

Logical 

Message  Type 

MS 

Channel 

AP  Mane  (Dest . ) 

Local  MPU 

Instance  (Dest.) 

Det  by  SysGen  Parameter 

A PC  Marne  (Dest.) 

Local  APC 

AP  Mane  (Source) 

Requesting  AP 

Instance  (Source) 

Assigned  by  MPU 

at  Init 

APC  Name  (Source) 

Local  APC 

Message  Serial  « 

Filled  in  by  Source  MPU 

Processing  Code 

Given  by  AP  Interface 

Message  Category 

D 

Priority  of  Source  AP 

From  AP  Char.  Table 

Integrity  Check  Flag 

0  (Default) 

Logging  Flag 

1 

Stat.  Collection  Flag 

1 

Test  Flag 

0  (Default) 

Delivery  Trigger  Flag 

0  (Default) 

Delivery  Time  Trigger 

blank  (Default) 

Delivery  Trig.  Cond. 

blank  (Default) 

Original  Source 

of  Msg.  Source 

AP 

Channel  ID 

of  Msg.  Source 

AP 

Continuation  Flag 

0 

DS  620142000 
1  November  1985 


Message  Type:  Paired  Message  Status  Return  Type  ID:  MR 

Nature  of  Message: 

Sent  in  response  to  a  Paired  Message  Status  Request.  The 
data  portion  contains  the  current  status  of  the  Paired 
Message  specified  in  the  request. 


Path:  Local  MPU  -  AP 


Header  Fields _ Header  Values _ Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 

A  PC  Hue  (Dest .  ) 

AP  Name  (Source) 
Instance  (Source) 

A PC  Name  (Source) 
Message  Serial  * 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  Return  Code 

092 
0005 

N  (Default) 

0 

MR 

Source  of  MS  Message 
Source  Inst  of  MS  Message 
Local  APC 
Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 
F 

From  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


PIC  X(5) 

88  Message- 
in-system 
88  Message- 
Hot  -Found 


E-66 


DS  620142000 
1  November  1985 


Message  Type:  Process  Name  Not  Pound  Type  ID:  HP 

Nature  of  Message: 

Sent  by  an  MPU  when  it  cannot  find  an  AP  specified  to  be 
aborted  in  the  AP  Status  Table.  This  is  a  possible 
response  to  an  Operator  Abort  Message. 


Path:  MPU  -  Monitor  AP 

Header  Fields  Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest . ) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  « 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat .  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A 

AP  Name 

PIC  X(10) 

092 

(specified 

in 

0012 

OA  Msg) 

N  (Default 

-  Native) 

0 

Instance 

PIC  X(2) 

MP 

(specified 

in 

Monitor  AP 

OA  Msg) 

Det  by  SysGen  Parameter 
Monitor's  APC 
Aborting  AP's  MPU 
Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 
E 

0  (Default) 

0  (Default  -  No) 

1  (Yes) 

1  (Yes) 

0  (Default  -  No) 

0  (Default  -  I  mined ) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


Message  Type:  Processing  Error* 


DS  680142000 
1  November  1985 

Type  ID:  SI 


Mature  of  Message: 

Message  sent  fron  an  MPU  when  it  enoounters  problees 
during  its  normal  processing.  The  header  portion  is  hard 
coded  in  the  event  that  the  problem  encountered  is  within  * 

the  MPU  itself. 


Path:  MPU  -  Monitor  AP 


Header  Fields  _ Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest . ) 
Instance  (Dest . ) 

APC  Marne  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Mane  (Source) 
Message  Serial  • 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tine  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  Error  Code  PIC  X(5) 

092 

0017  Mane  String  PIC  1(7) 

M  (Default  -  Mative) 

0  Processing  Code  PIC  X(5) 

31 

Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 
E 

0  (Default) 

0  (Default  -  Mo) 

1  (Yes) 

1  (Yes) 

0  (Default  -  Mo) 

0  (Default  -  lamed) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


E-68 


DS  620142000 
1  November  1985 


Message  Type:  Rebuild  Tables  Type  ID:  RT 

Mature  of  Message: 

Used  on  Startup  by  Monitor  to  inf ora  an  MPU  that  it  Bust 
rebuild  its  tables  from  the  CDM.  This  aessage  applies  only 
to  those  MPU's  that  Bust  build  their  tables  before  the 
CDMRP  cones  up.  It  is  used  only  where  there  is  a  table 
configuration  change. 


Path:  Monitor  -  MPU 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Fornat 
Header  Length 
Data  Length 
Binary/Mat ive  Flag 
Priority  Flag 
Message  Type 
AP  Mane  (Dost . ) 
Instance  (Dest.) 

A PC  Mane  (Dest.) 

AP  Mane  (Source) 
Instance  (Source) 

A PC  Mane  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tine  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  M/A 

092 

0 

M  (Default  -  Native) 

1 

RT 

MPU 

Det  by  SysGen  Paraaeter 
MPU's  APC 
Monitor  AP 

Det  by  SysGen  Paraaeter 
Monitor's  APC 
Filled  in  by  Source  MPU 
1 
D 

0  (Default) 

0  (Default  -  No) 

1  (Tes) 

1  (Yes) 

0  (Default  -  No) 

0  (Default  -  lamed ) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
specified  or  default 
0 


DS  620142000 
1  November  1985 


Message  Type:  Recoverable  Error  Type  ID:  RE 

Mature  of  Message: 

Notification  that  a  given  AP  has  encountered  a  recoverable 
error . 


Path:  AP  -  Monitor  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Hat ive  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest . ) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  AP  Error  Code  PIC  X(5) 

092 
0005 

N  (Default) 

0 

RE 

Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
AP  where  error  occurred 
Assigned  by  MPU  at  AP  Init 
AP's  APC 

Filled  in  by  Source  MPU 
Given  by  AP  Interface 
E 

From  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Source  AP 
of  Source  AP 
0 


DS  620142000 
1  Novenber  1985 


Message  Type:  Resource  Unavailable*  Type  ID:  3S 

Nature  of  Message: 

Inf ormational  Message  sent  to  Monitor  AP  when  an  MPU 
rejects  any  Message  due  to  the  fact  of  a  needed  resource 
being  unavailable. 


Path:  MPU  -  Monitor 


Header  Fields  Header  Values  Data  Fields  Data  Values 


Header  Fornat 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Naae  (Dest . ) 
Instance  (Dest.) 

APC  HaMe  (Dest.) 

AP  Nane  (Source) 
Instance  (Source) 

APC  Nane  (Source) 
Message  Serial  « 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tine  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  Error  Code  PIC  X(5) 

092 

0017  Nane  String  PIC  X(7) 

N  (Default  -  Native) 

0  Processing  Code  PIC  X(5) 

33 

Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
MPU 

Det  by  SysGen  Parameter 
MPU's  APC 

Filled  in  by  Source  MPU 
1 
E 

0  (Default) 

0  (Default  -  No) 

1  (Yes) 

1  (Yes) 

0  (Default  -  No) 

0  (Default  -  Inned) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


E-71 


DS  620142000 
1  November  1985 


Message  Type:  Shutdown  AP  Type  ID:  DA 

Mature  of  Message: 

Command  to  an  MPU  telling  it  to  shut  down  one  of  its 
resident  APs.  The  MPU  will  handle  the  actual  shutdown  in 
accordance  with  the  given  AP's  characteristics.  Where  the 
given  AP  has  active  child  AP’s,  the  MPU  will  also  send 
shutdown  AP  messages  to  the  child  AP  MPUs. 


Path:  Monitor  AP  -  MPU;  MPU  -  MPU 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 

A 

AP  Marne  (to  be 

Header  Length 

092 

shut  down) 

Data  Length 

0015 

Instance 

Binary/Native  Flag 

M  (Default) 

(where  known) 

Priority  Flag 

1 

Channel  ID 

Message  Type 

DA 

AP  Marne  (Dost . ) 

Shutting  down 

AP's  MPU 

Instance  (Dest.) 

Det  by  SysGen 

Parameter 

APC  Marne  fDest.) 

AP's  APC 

AP  Marne  (Source) 

Monitor  AP  or 

Parent 

AP  MPU 

Instance  (Source) 

Det  by  SysGen 

Parameter 

APC  Marne  (Source) 

Local  APC 

Message  Serial  • 

Filled  in  by  i 

Source  MPU 

Processing  Code 

1 

Message  Category 

C 

Priority  of  Source  AP 

From  AP  Char. 

Table 

Integrity  Check  Flag 

0  (Default) 

Logging  Flag 

1 

Stat.  Collection  Flag 

1 

Test  Flag 

0  (Default) 

Delivery  Trigger  Flag 

0  (Default) 

Delivery  Time  Trigger 

blank  (Default) 

Deli very  Trig.  Cond . 

blank  (Default) 

Original  Source 

of  Msg.  Source  AP 

Channel  ID 

of  Msg.  Source  AP 

Continuation  Flag 

0 

PIC  X(10) 
PIC  X(2) 
PIC  X(3) 


E-72 


DS  620142000 
1  November  1985 


Message  Type:  Shutdown  AP  Cluster  Type  ID:  DC 

Nature  of  Message: 

System  Command  to  gracefully  shut  down  a  given  cluster. 
Implies  that  the  cluster's  MPU  will  handle  the  shutdown  of 
all  resident  AP's  and  will  also  shut  itself  down  after  all 
AP's  and  messages  are  cleared.  Where  resident  AP's  have 
child  AP's  and  the  shutdown  type;  host  or  APC ,  the  MPU 
will  also  send  shutdown  AP  messages  to  the  child  AP  MPU's 
(where  the  child  AP's  are  off -APC). 


Path:  Monitor  AP  -  MPU 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest . ) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  « 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A 

092 

0001 

N  (Default) 
1 

DC 

MPU 


Shutdown  Type  PIC  X 

88  IISS 
88  Host 
88  APC 


Det  by  SysGen  Parameter 
MPU's  APC 
Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
Filled  in  by  Source  MPU 
1 
D 


From  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
specified  or  default 
0 


DS  620142000 
1  November  1985 


Message  Type:  Shutdown  COMM  AP  Type  ID:  TR 

Mature  of  Message: 

Message  to  a  given  COMM  AP  telling  it  to  shut  itself  down. 
Path:  Monitor  AP  -  COMM  AP 


Header  Fields  Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  « 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  N/A 

092 
0 

N  (Default  -  Native) 

0 

TR 

COMM  AP 

Det  by  SysGen  Parameter 
GOMM's  APC 
Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
Filled  in  by  Source  MPU 
1 
E 

0  (Default) 

0  (Default  -  No) 

1  (Yes) 

1  (Yes) 

0  (Default  -  No) 

0  (Default  -  lamed) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
COMM  AP's  Channel 
0 


E-74 


DS  620142000 
1  November  1985 


Message  Type:  Shutdown  Most  Type  ID:  SH 
Mature  of  Message: 

System  command  from  one  Monitor  AP  to  an  off -host  sibling 
telling  the  sibling  to  shutdown  all  IISS  functionality  on 
its  host.  The  off-host  Monitor  AP  will .upon  receipt,  send 
Shutdown  APC  messages  to  all  of  its  on-host  APC's. 


Path:  Monitor  AP  -  Monitor  AP 


Header  Fields  _  Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Mative  Flag 
Priority  Flag 
Message  Type 
AP  Marne  (Dest . ) 
Instance  (Dest.) 

APC  Marne  (Dest.) 

AP  Mane  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  * 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A 
092 
0 

M  (Default) 

0 
SH 

Off-host  Monitor  AP 
Det  by  SysGen  Parameter 
Off -Host  Monitor's  APC 
On-host  Monitor  AP 
Det  by  SysGen  Parameter 
Monitor's  APC 
Filled  in  by  Source  MPU 


M/A  -  Host  to 
be  shutdown  is 
implied  by 
Dest.  Monitor 
AP  Marne 


1 

B 

0 

0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


DS  620142000 
1  November  1985 


Message  Type:  Shutdown  Link  Type  ID:  SD 

Nature  of  Message: 

Command  to  terminate  an  active  link  between  a  COMM  AP  and 
its  off-host  sibling. 


Path:  Monitor  AP  -  COMM  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest . ) 
Instance  (Dest.) 

A PC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  • 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  N/A 

092 
0 

N  (Default) 

0 

SD 

COMM  AP 

Det  by  SysGen  Parameter 
COMM's  APC 
Monitor  AP 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 
B 
0 

0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
COMM  AP's  Channel 
0 


E-76 


DS  620142000 
1  Novenber  1985 


Message  Type:  Signal  Table  Error  Type  ID:  SE 

Mature  of  Message: 

Sent  to  the  nessage  source  AP  on  the  occurrence  of  an 
entry-not -found  in  the  NTM  Tables.  This  nessage  is  sent 
only  when  the  error  creates  a  situation  where  the  source 
AP's  nessage  cannot  be  processed.  The  nessage  contains  a 
brief  description  of  the  error  and  where  it  occurred. 


Path :  MPU  AP 


Header  Fields 

Header  Values 

Data  Fields 

Data  Values 

Header  Fornat 

A 

Error  Source 

PIC  X(10) 

Header  Length 

092 

NTH  Error 

Data  Length 

0087 

Return 

PIC  X(5) 

Binary/Hat ive  Flag 

M  (Default) 

Error 

Priority  Flag 

0 

Description 

PIC  X(72) 

Message  Type 

SE 

AP  Nane  (Dest . ) 

Source  of  Message  Causing  Error 

Instance  (Dest.) 

Det  by  SysGen 

Paraneter 

APC  Mane  (Dest.) 

Source  Msg  APC 

AP  Mane  (Source) 

MPD  where  error  occured 

Instance  (Source) 

Det  by  SysGen 

Paraneter 

APC  Mane  (Source) 

Local  APC 

Message  Serial  * 

Filled  in  by  Source  MPU 

Processing  Code 

1 

Message  Category 

E 

Priority  of  Source  AP  From  AP  Char. 

Table 

Integrity  Check  Flag 

0  (Default) 

Logging  Flag 

1 

Stat.  Collection  Flag  1 

Test  Flag 

0  (Default) 

Delivery  Trigger  Flag  0  (Default) 

Delivery  Tine  Trigger  blank  (Default) 

Delivery  Trig.  Cond. 

blank  (Default) 

Original  Source 

of  Msg.  Source  AP 

Channel  ID 

000 

Continuation  Flag 

0 

DS  620142000 
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Message  Type:  Shutdown  Pending  Type  ID:  SP 

Mature  of  Message: 

Notification  that  am  IISS  shutdown  of  a  specified  type 
will  begin  in  X  minutes.  This  notification  may  be 
overriden  by  a  cancel  shutdown  CCS)  Message. 


Path:  Monitor  AP  -  01  AP 

Header  Fields  Header  Values _ Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  Shutdown  Data  PIC  X(2) 

092  Time  Until  PIC  X(2) 

0004  Shutdown 

N  (Default)  (in  Minutes) 

1 

SP 

01  MPO 

Det  by  SysGen  Parameter 
01' s  APC 
Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
Filled  in  by  Source  MPU 
1 
C 
0 

0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


E-78 
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Message  Type:  Soft  Shutdown  Type  ID:  SD 

Mature  of  Message: 

Message  telling  a  specified  AP  to  shut  itself  down.  This 
message  can  only  be  sent  to  an  AP  that  has  the  internal 
logic  required  to  perform  its  own  shutdown  (as  determined 
froa  the  AP  Characteristics  Table).  This  message  is  sent 
as  a  result  of  receiving  a  Shutdown  APC  message. 


Path:  MPU  -  AP 


Header  Fields _ Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Mat ive  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest . ) 
Instance  (Dest.) 

APC  Marne  (Dest.) 

AP  Marne  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Serial  # 

Code 

Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat .  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  M/A 

092 

0 

M  (Default) 

0 

SD 

AP  to  be  shutdown 
Det  by  SysGen  Parameter 
Local  APC 
Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
0 
C 
0 

0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


UHUtutumv 


nmiAKniuwnvKira 


1WIW 
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Message  Type:  Start  Link  Type  ID:  SL 

Nature  of  Message: 

Message  to  a  specified  COMM  AP  telling  it  to  establish  the 
link  between  itself  and  its  off -host  sibling.  The  MP0  will 
create  an  entry  in  the  pair  table  to  set  a  wait  on  the 
link  status  return. 


Path:  Monitor  AP  -  COMM  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest . ) 
Instance  (Dest.) 

APC  Name  (Dest . ) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  * 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  N/A  -  the  dest. 

.  092  COMM  AP  can 

0  only  start 

N  (Default)  one  link 

0 
SL 

COMM  AP 

Det  by  SysGen  Parameter 
COMM  APC 
Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
Filled  in  by  Source  MPU 
1 
B 

From  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
COMM  AP's  Channel 
0 


I 


i 
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Message  Type:  Start  MPU  Type  ID:  SC 

Nature  of  Message: 

Command  to  startup  (spawn)  a  given  MPU. 

Path:  Monitor  AP  -  Monitor's  MPU 


Header  Fields  Header  Values  Data  Fields  Data  Values 


Header  Format  A  Process  Name 

Header  Length  092 


Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest . ) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


0012 

N  (Default) 

1 

SC 

Monitor's  MPU 
Det  by  SysCSen  Parameter 
Monitor's  APC 
Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
Filled  in  by  Source  MPU 
1 
C 
0 

0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


PIC  X( 12) 
(of  MPU  to 
be 

started) 
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Message  Type:  System  State  Type  ID:  SS 

Nature  of  Message: 

Sent  to  an  AP  when  the  AP's  "alive”  status  is  known.  This 
message  serves  to  inform  the  AP  of  the  current  state  of 
the  IISS ,  along  with  certain  characteristics  of  the  AP. 


Path :  MPU  AP 

Header  Fields _  _ Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest . ) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A 

092 

0022 

N  (Default) 
0 
SS 


System  State 
Logical  Channel 
Original  Source 
MPU  Instance 
Number  of 
Mailboxes 


"Alive"  AP 

Det  by  SysGen  Parameter 
Alive  AP's  APC 


Local  MPU 


Det  by  SysGen  Parameter 
Local  APC 


Filled  in  by  Source  MPU 
1 
E 


From  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
000 
0 


PIC  X 
PIC  X(3) 
PIC  X( 15) 
PIC  X(2) 
PIC  X 
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Message  Type:  Table  Data  Request  Type  ID:  DR 

Mature  of  Message: 

Message  to  the  CDH  requesting  a  download  of  the  static 
table  data  values.  This  is  done  when  the  MPU  is  told  of  a 
CDM  configuration  change.  This  Message  is  hard  coded  as 
part  of  the  MPU's  startup  file. 


Path:  MPU  -  CDMRP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Marne  (Dest . ) 
Instance  (Dest . ) 

A PC  Mame  (Dest.) 

AP  Mame  (Source) 
Instance  (Source) 

A PC  Mame  (Source) 
Message  Serial  * 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tine  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  M/A 

092 
0 

M  (Default) 

0 

DR 

CDMRP 

Det  by  SysGen  Parameter 
CDK's  A PC 
Requesting  MPU 
Det  by  SysGen  Parameter 
Requesting  MPU's  APC 
Filled  in  by  Source  MPU 
0 
B 
0 

0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
specified 
0 
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Message  Type:  Table  Data  Return 


Type  ID:  DL 


Mature  of  Message: 

Indicates  that  the  data  following  the  header  is  to  be  used 
to  update  the  MPU's  local  tables. 


Path:  CDMRP  -  MPU 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Mat ive  Flag 
Priority  Flag 
Message  Type 
AP  Najne  (Best .  ) 
Instance  (Dest.) 

APC  Mane  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Mane  (Source) 
Message  Serial  * 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  Updated  Static  Up  to 

092  Table  Data  PIC  X(1908) 

up  to  1908 
M  (Default) 

0 

DL(Dest . ) 

Requesting  MPU 

Det  by  SysGen  Parameter 

Requesting  MPU's  APC 

CDMRP 

Det  by  SysGen  Parameter 
CDM's  APC 

Filled  in  by  Source  MPU 
From  AP  Int 
F 
0 

0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
from  DR  Msg 
from  DR  Msg 
as  req'd 
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Message  Type:  Table  Status  Request*  Type  ID:  TS 

Mature  of  Message: 

Request  from  an  MPU  at  its  startup  for  the  configuration 
status  of  its  tables.  This  message  is  hard  coded  as  part  of 
the  MPU's  startup  file. 


Path:  MPU  -  Monitor  AP 


Header  Fields  _ Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest . ) 
Instance  (Dest.) 

APC  Marne  (Dest.) 

AP  Marne  (Source) 
Instance  (Source) 

APC  Marne  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  Status  Code 

092  Filler 

0017 

M  (Default) 

0 

TS 

Monitor  AP 

Det  by  SysGen  Parameter 

Monitor's  APC 

MPU 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 
E 
0 

0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
MPU's  Channel 
0 


PIC  X(5) 
PIC  X( 12) 
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Message  Type:  Table  Status  Return  Type  ID:  ST 

Nature  of  Message: 

Current  configuration  status  of  the  MPU's  tables.  Upon 
receipt  of  this  message,  the  MPU  will  know  whether  it  can 
build  its  tables  completely  from  its  existing  files  or  if 
it  has  to  request  its  static  table  data  from  the  CDM. 


Path:  Monitor  AP  -  MPU 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest . ) 
Instance  (Dest . ) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  * 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  Table  Status 

092 
0001 

N  (Default) 

0 

TR 

Requesting  MPU 
Det  by  SysGen  Parameter 
Requesting  MPU's  APC 
Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
Filled  in  by  Source  MPU 
1 
F 
0 

0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg  Source  AP 
MPU ‘ s  Channe 1 
0 


PIC  X 
88  Local 
Tables 
O  K 
88  Get 
Data 
from 
CDM 


L 
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Message  Type:  Tables  Rebuilt  Type  ID:  RB 

Mature  of  Message: 

Sent  to  Monitor  upon  successful  (or  unsuccessful) 
completion  of  the  task  of  rebuilding  local  tables  using 
updated  CDM  data. 


Path:  MPU  -  Monitor 


Header  Fields _ Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Mat ive  Flag 
Priority  Flag 
Message  Type 
AP  Mane  (Dest . ) 
Instance  (Dest.) 

A PC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  « 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat .  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tiue  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  Table  Status 

092 
0001 

M  (Default  -  Native) 

0 

RB 

Monitor  AP 

Det  by  SysGen  Parameter 

Monitor's  APC 

MPU 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
0 
F 

0  (Default) 

0  (Default  -  No) 

1  (Yes) 

1  (Yes) 

0  (Default  -  No) 

0  (Default  -  lined) 
blank  (Default) 
blank  (Default) 
of  Msg  Source  AP 
MPU ' s  Channe 1 
0 


PIC  X 
88  Rebuilt 
88  Unsuc¬ 
cessful 
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Message  Type:  Tiaeout  Expired*  Type  ID:  TE 

Mature  of  Message: 

Message  inforaing  an  AP  that  the  tiaeout  on  a  paired 
aessage  has  expired  before  the  response  aessage  arrived. 
This  aessage  can  only  be  sent  to  AP's  having  the  logic 
required  to  accept  unsolicited  aessages  (based  on  AP's 
On-Tiaeout  characteristic). 


Path:  MPU  -  Local  AP 


Header  Fields 


Header  Values _  Data  Fields  Data  Values 


Header  Foraat 
Header  Length 
Data  Length 
Binary/Mative  Flag 
Priority  Flag 
Message  Type 
AP  Hue  (Dest .  ) 
Instance  (Dest.) 

A PC  Naae  (Dest.) 

AP  Naae  (Source) 
Instance  (Source) 

A PC  Naae  (Source) 
Message  Serial  * 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Tiae  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  Error  Code  PIC  X(5) 

092  Message  Header  PIC  X(92) 

0097 

N  (Default  -  Native) 

0 

TE 

AP  Requesting  Pair 
Assigned  by  MPU  at  AP  Init 
AP's  APC 
Local  MPU 

Det  by  SysGen  Paraaeter 
Local  APC 

Filled  in  by  Source  MPU 
1 
E 

0  (Default) 

0  (Default  -  No) 

1  (Yes) 

1  (Yes) 

0  (Default  -  No) 

0  (Default  -  Iaaed ) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 
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Message  Type:  Onsol  idled  A  PC  Termination*  Type  ID:  CE 

Mature  of  Message: 

Message  sent  when  an  A PC  shuts  down  for  internal  reasons 
(other  than  on  operator  ooaaand). 


Path:  MPO  -  Monitor  AP 


Header  Fi e Ids _ Header  Values  Data  Fields  Data  Values 


Header  Foraat 

A  Error  Code 

PIC  X(5) 

Header  Length 

092  Filler 

PIC  X( 12) 

Data  Length 

0017 

Binary /Mat ive  Flag 

M  (Default) 

Priority  Flag 

0 

Message  Type 

CE 

AP  Mane  (Dest . ) 

Monitor  AP 

Instance  (Dest.) 

Det  by  SysGen  Parana ter 
Monitor's  APC 

A PC  Mame  (Dest . ) 

AP  Mane  (Source) 

MPU  of  Terminating  APC 

Instance  (Source) 

Det  by  8ysGen  Parameter 

A PC  Mane  (Source) 

Terminating  APC 

Message  Serial  t 

Filled  in  by  Source  MPO 

Processing  Code 

1 

Message  Category 

F 

Priority  of  Source  AP 

Fron  AP  Char.  Table 

Integrity  Check  Flag 

0  (Default) 

Logging  Flag 

1 

Stat.  Collection  Flag 

1 

Test  Flag 

0  (Default) 

Delivery  Trigger  Flag 

0  (Default) 

Delivery  Tine  Trigger 

blank  (Default) 

Delivery  Trig.  Cond. 

blank  (Default) 

Original  Source 

of  Msg.  Source  AP 

Channel  ID 

of  Msg.  Source  AP 

*  Continuation  Flag 

0 

E-89 

t 

• 

> 

• 

« 

* 

\ 

i 

A  A  A  .\  A  -  .  A  A  - 

* 

« 

•*  ‘  A  A/.  A  A  A  * 

DS  620142000 
1  November  1985 


Message  Type:  Unsolicited  Initiation  Accept  Type  ID:  IA 
Mature  of  Message: 

Acknowledgement  that  an  AP  was  initiated  upon  receipt  of 
an  unsolicited  message.  Upon  receipt  of  this  ACK,  the  MPU 
will  modify  the  entry  in  the  Child  Status  Table  to 
indicate  a  confirmed  child  AP. 


Path:  MPU  -  MPU 

Header  Fields _  Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Marne  (Dest . ) 
Instance  (Dest.) 

APC  Marne  (Dest.) 

AP  Marne  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  * 

Processing  Code 
Message  Category 
Priority  of  Source  AP 

Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A 

092 

0025 

M  (Default) 
0 
IA 


Process  Name  (of  PIC 
Init  Msg  X( 12) 

Source  AP 


Init  Msg  Source  MPU 
Det  by  SysGen  Parameter 

Source  APC  AP  Marne  (of  AP  PIC  X(10) 

Init  AP's  MPU  Init  by  Unsol. 

Det  by  SysGen  Msg) 

Parameter 


Init  AP's  APC 
Filled  in  by 
Source  MPU 
1 
G 

From  AP  Char. 
Table 

0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 


Channel  ID  PIC  X(3) 
(Child  Init. 

Under  from 
Init  Msg) 


of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 
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Message  Type:  Unstable  Table  Type  ID:  UT 

Nature  of  Message: 

Sent  on  the  occurrence  of  an  entry-not-found  in  the  MTM 
Tables  where  the  error  occurs  due  to  a  problem  within  the 
NTM  as  opposed  to  bad  input.  The  message  carries 
information  that  pinpoints  the  error  for  the  operator.  In 
most  cases,  this  message  should  result  in  the  Operator 
shutting  down  the  NTM. 


Path :  MPU  AP 


Header  Fields _ Header  Values 


Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest . ) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  * 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


Table  Name 
Module  Name 
Error  Field 
Error  Value 
Error  Return 


A 
092 
0044 

N  (Default) 

0 
UT 

VAX  Monitor 

Det  by  SysGen  Parameter 
Monitor's  APC 
MPU  where  error  occurred 
Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 
E 


From  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
000 
0 


PIC  X(3) 
PIC  X(6) 
PIC  X(10) 
PIC  X(20) 
PIC  X(5) 
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Message  Type:  Unsuccessful  Initiation  Type  ID:  MI 

Mature  of  Message: 

Sent  to  the  MPU  of  the  source  AP  of  a  specific  initiation 
message  when  the  requested  initiation  is  not  successful. 
Upon  receipt,  the  source  Cor  Parent)  MPU  will  delete  the 
relevant  child  table  entry. 


Path:  Child  MPU  -  Parent  MPU 


Header  Fields  Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Hative  Flag 
Priority  Flag 
Message  Type 
AP  Marne  (Dest . ) 
Instance  (Dest.) 

A PC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  AP  Marne  (from 

092  Init  Msg) 

0022  Parent  AP 

M  (Default  -  Native Process  Marne 
0 
MI 

Source  MPU  of  Init  Msg 
Det  by  SysGen  Parameter 
Source  MPU's  APC 
Dest  MPU  of  Init  Msg 
Det  by  SysGen  Parameter 
Dest  MPU's  APC 
Filled  in  by  Source  MPU 
1 
E 

0  (Default) 

0  (Default  -  No) 

1  (Yes) 

1  (Yes) 

0  (Default  -  No) 

0  (Default  -  Immed) 
blank  (Default) 
blank  (Default) 
from  Init  Msg 
from  Init  Msg 
0 


PIC  X(10) 
PIC  X( 12) 
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Message  Type:  Update  APC  Table  Type  ID:  UA 

Mature  of  Message: 

Message  informing  an  off -host  Monitor  AP  of  APC  Status 
table  updates . 


Path:  Monitor  AP  -  Monitor  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 

A  Status  Update 

Header  Length 

092 

Data  Length 

0001 

Binary/Native  Flag 

N  (Default) 

Priority  Flag 

0 

Message  Type 

UA 

AP  Name  (Dest . ) 

Off -Host  Monitor  AP 

Instance  (Dest.) 

Det  by  SysGen  Parameter 

APC  Name  (Dest.) 

Off-Host  Monitor's  APC 

AP  Name  (Source) 

VAX  Monitor  AP 

Instance  (Source) 

Det  by  SysGen  Parameter 

APC  Name  (Source) 

VAX  Monitor's  APC 

Message  Serial  * 

Filled  in  by  Source  MPU 

Processing  Code 

1 

Message  Category 

E 

Priority  of  Source  AP 

From  AP  Char.  Table 

Integrity  Check  Flag 

0 

Logging  Flag 

1 

Stat .  Collection  Flag 

1 

Test  Flag 

0  (Default 

Delivery  Trigger  Flag 

0  (Default 

Delivery  Time  Trigger 

blank  (Default) 

Delivery  Trig.  Cond. 

blank  (Default) 

Original  Source 

of  Msg.  Source  AP 

Channel  ID 

of  Msg.  Source  AP 

Continuation  Flag 

0 
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Message  Type:  Update  Host  Table  Type  ID:  UH 

Mature  of  Message: 

Message  informing  an  off-host  Monitor  AP  of  Host  table 
updates . 


Path:  Monitor  AP  -  Monitor  AP 


Header  Fields _ Header  Values  Data  Fields  Data  Values 

Header  Format  A  Host  Mamie  PIC  X(3) 

Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Marne  (Dest . ) 

Instance  (Dest.) 

A PC  Marne  (Dest.) 

AP  Marne  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  • 

Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 

Original  Source 
Channel  ID 


E-94 


092  Status  Update  PIC  X 

0004 

N  (Default) 

0 

UA 

Off-Host  Monitor  AP 
Det  by  SysGen  Parameter 
Off -Host  Monitor's  APC 
Local  Monitor  AP 
Det  by  SysGen  Parameter 
Local  Monitor  APC 
Filled  in  by  Source  MPU 
1 
E 

From  AP  Char .  Table 
0  (Default) 

1 

1 

0  (Default 
0  (Default 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
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E.2  Eat ion  Flag 

E.2.1  Error  Message  Handling 

When  an  error  occurs  within  (or  is  detected  by)  the  MPO, 
an  error  message  is  sent  to  either  the  Monitor  AP,  the  source  AP 
(where  the  error  is  related  to  a  message),  or  both.  However, 
sending  an  error  message  in  the  normal  fashion  (by  writing  to 
the  MPU's  own  mailbox  and  performing  all  the  message  management 
functions)  could  easily  result  in  an  infinite  loop.  To  avoid 
this,  the  MPU  will  have  an  error  message  formatting  routine  that 
formats  and  effects  the  send  of  the  error  messages  to  either 
Monitor  AP,  the  Source  AP,  or  both.  In  the  event  that  the 
Monitor  AP's  mailbox  is  inaccessible,  the  fatal  error  processing 
routine  (ERRPRO)  will  be  called.  The  MPU's  error  formatting 
routine  will  have  access  to  two  “canned"  headers  and  will  be 
accessed  by  two  MPU  routines  described  below. 

1.  CALL  “ SNDMON “  USING:  Err or -Code 

Name-String 
Process ing -Code 

SNDMON  will  provide  the  error 
message  formatting  routine  with  the 
data  needed  to  complete  a  "canned” 
header  (in  this  case,  one  where  the 
destination  is  the  on-host  Monitor 
AP).  The  formatting  routine  will 
move  the  data  values  to  their  proper 
fields  and  send  the  message.  This 
call  handles  messages  of  Type  51,  32 
and  33.  (See  Appendix  E  for 
formats) . 

Error  Code 
Name-String 
Processing-Code 

2.  CALL  "SNDSAP"  USING:  Error-Code 

Entire  Offending  Message 
Header 

Description:  SNDSAP  will  provide  the  error 

message  formatting  routine  with  the 
data  needed  to  complete  a  "canned” 
header  (in  this  case,  one  where  the 
destination  is  the  source  AP  of  the 
offending  message).  The  formatting 


Description: 


Inputs : 
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routine  will  nove  the  data  values  to 
their  proper  fields  and  send  the 
nessage.  This  call  handles  Messages 
of  type  32,  33.  and  34. (See  Appendix 
E  for  fornats). 

E.2.2  Error  Message  Description 

Table  E-3  lists  the  errors  identified  for  the  HIM.  Each 
error  is  described  along  with  the  values  for  their  calls  to  the 
error  sassage 


TABLE  E-3 

ERROR  MESSAGES  DESCRIPTORS 


Error 

Error  Description _ Code  Parameters 


Can't  write  to  Mailbox  31001 

Can't  Create  Mailbox  31002 

Can't  Read  Mailbox  31003 

Mailbox  Disconnect  31004 

Error 

Call  Wait  Error  31005 


Processing-Code  »  IPC  Code 
Set  Tine  Error  31006 

Mapping  Error  31007 


Data  Length  -  17 
Bane-String  »  Mailbox  lane 
Processing-Code  *  IPC  Code 

Data  Length  -  17 
Naae-Str ing  -  Mailbox  Mane 
Processing-Code  -  IPC  Code 

Data-Length  -  17 
Mane-String  -  Mailbox  Mane 
Process ing -Code  -  IPC  Code 

Data-Length  -  17 
Naae-String  -  Mailbox  Maae 
Process ing -Code  -  IPC  Code 

Data-Length  -  17 
Naae-String  -  MTM  Module  Ease 
or  AP  Maae  if  API  error 


Data-Length  -  17 
Maae-String  -  MTM  Module  Ease 
Process ing -Code  -  IPC  Code 

Data-Length  «  17 


E-96 
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Job  Process 
Inforaation  Error 


Process  Start  Error 


Hane-String  -  HTM  Module  Maae 
or  AP  Maae  if 
API  error 

Processing-Code  -  OS  Code 

I 

51008  Data-Length  -  17 

Maae-String  -  HTM  Module  Maae 
or  AP  Maae  if  API  error 
Processing-Code  -  OS  Code 

31009  Data-Length  *  17 

Mane-String  -  Process  Maae 
Processing-Code  •  OS  Code 
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TABLE  E-S 

ERROR  MESSAGES  DESCRIPTIOMS  (Continued) 
Error 


Error  Description 

Code 

Parameters 

Process  Abort  Error 

31010 

Data-Length  -  17 
Maae-String  *  Process  Mane 
Processing -Code  ■  OS  Code 

Process  Mot  Found 

31011 

Data  Length  -  17 
Name-String  -  Process  Marne 
Processing -Code  -  OS  Code 

File  Read  Error 

31012 

Data  Length  -  17 
Maae-String  -  File  Maae 
Processing-Code  -  OS  Code 

File  Write  Error 

31013 

Data-Length  -  17 
Maae-String  -  File  Maae 
Processing -Code  -  OS  Code 

File  Close  Error 

31014 

Data-Length  -  17 
Maae-String  -  File  Maae 
Processing -Code  -  OS  Code 

File  Open  Error 

31015 

Data-Length  -  17 
Maae-String  «  File  Name 
Processing-Code  -  OS  Code 

Table  Read  Error 

31016 

Data-Length  «  17 
Maae-String  -  Table  Maae 
Processing-Code  -  OS  Code 

Table  Write  Error 

31017 

Data-Length  -  17 
Maae-String  -  Table  Maae 
Processing-Code  -  OS  Code 

CDM  Data  Access  Errors 

31018 

Data-Length  -  17 
Naae-String  -  MPU  Maae 
Process ing-Code  -  Blank 

Message  Arrived  at 

Wrong  A PC 

31019 

Data-Length  -  17 
Nane-String  -  Sending  MPU 
Processing-Code  -  Blank 

I 


£-98 
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TABLE  E-3 

ERROR  MESSAGES  DESCRIPTIONS  (Continued) 


Error 

Code  Parameters 

51020  Data-Length  -  17 

Name-String  «  MPO  Module  Name 
AP  Name  if  AP  Interface 
Processing -Code  -  OS  Code 


Time-out  Error 

31021 

Data-Length  -  17 
Name-String  - 
Processing-Code 

COBOL  Call  Error 

31022 

Data-Length  -  17 
Name-String  -  Offending  AP 
Processing-Code 

Exception  Condition 

31023 

Data-Length  »  17 
Name-String  -  AP  Having 
Exception  Condition 
Processing  Code 

Entry-Not-Found 

31024 

Data-Length  -  17 
Name-String  -  Table  Name 
Processing-Code  -  Blanks 

Entry-Not-Deleted 

31025 

Data-Length  -  17 
Name-String  -  Table  Name 
Processing-Code  -  Blanks 

Invalid  Search  Field 

31026 

Data-Length  -  17 
Name-String  -  Table  Name 
Processing-Code  -  Blanks 

Cancel  Timeout  Error 

31027 

Data-Length  -  17 
Name-String- 
Processing  Code  - 

IPC  Error 

31028 

Data-Length  -  17 
Name-String  -  Error  Entity 
Processing -Code  -  IPC  Code 

Error  Description 


OS  Call  Error 

(for  those  not 

or  covered  specifically) 


E-99 
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TABLE  E-3 

ERROR  MESSAGES  DESCRIPTIONS  (Continued) 


Error  Description 

Invalid  Category  in 
Message  Header 


Error 

Code 

32001 


Invalid  Header  Format 


32002 


Invalid  Header  Length 


32003 


Invalid  Binary/Mat ive 


32004 


Invalid  Message  Type 


32005 


Parameters 

On  CALL  "SMDMON” 

Data  Length  -  17 
Name-String  -  Process  Name 
Processing-Code  •  OS  Code 
On  CALL  "SNDSAP" 

Offending  Header 

On  CALL  " SNDMON" 

Data  Length  -  17 
Name-String  -  Source  AP 
Processing-Code  »  Blank 
On  CALL  " SNDSAP “ 

Offending  Header 

On  CALL  “SNDMON* 

Data-Length  ■  17 
Name-String  -  Source  AP 
Processing-Code  -  Blank 
On  CALL  "SNDSAP" 

Offending  Header 

On  CALL  "SNDMON*  Flag 
Data-Length  -  l 
Name-String  -  Source  AP 
Processing-Code  ■  Blank 
On  CALL  " SNDSAP " 

Offending  Header 

On  CALL  * SNDMON * 

Data-Length  -  17 
Name-String  -  Source  AP 
Processing-Code  ■*  Blank 
On  CALL  "SNDSAP" 

Offending  Header 


E-100 
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TABLE  E-3 

ERROR  MESSAGES  DESCRIPTIONS  (Continued) 


Error  Description 
Invalid  Source  AP 


Invalid  Source 
Instance 


Invalid  Source  APC 
Marne 


Invalid  (Header) 
Processing  Code 


Invalid  Continuation 
Flag 


Invalid  Data  Length 


Error 

Code  Parameters 


32006  On  CALL  "SNDMON" 

Data-Length  -  0 
Name-String  -  Blank 
Processing -Code  *  Blank 
On  CALL  "SNDSAP" 

M/A 

32007  On  CALL  "SMDMON" 

Data  Length  -  17 
Name-String  -  Source  AP 
Processing-Code  ■  Blank 
On  CALL  “SNDSAP" 

N/A 

32008  On  CALL  "SMDMON" 

Data  Length  -  17 
Name-String  -  Source  AP 
Name 

Processing-Code  -  Blank 
On  CALL  "SNDSAP" 

Offending  Header 

32009  On  CALL  " SMDMON " 

Data-Length  -  17 
Name-String  -  Source 
Processing -Code  -  Blank 
On  CALL  "SNDSAP" 

Offending  Header 

32010  On  CALL  "SNDMON" 

Data-Length  -  1 
Name-String  «  Source  AP 
Processing -Code  «  Blank 
On  CALL  "SNDSAP" 

Offending  Header 

32011  On  CALL  "SNDMON" 

Data-Length  -  17 
Name-String  -  Source  AP 
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Processing-Code  »  Blank 
On  CALL  "SNDSAP" 

Offending  Header 


t 

t 

; 
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TABLE  E-S 

ERROR  MESSAGES  DESCRIPTIONS  (Continued) 

t 


Error 

Error  Description _ Code  Parameters 


Invalid  Message  Priority  32012  On  CALL  “SMDMOM 

Data-Length  ■  17 
Mane  String  -  Source  AP 
Processing  Code  ■  Blank 
On  CALL  “SMDSAP" 
Offending  Header 


Resource  Unavailable 


-or- 
Table  Full 


33001  On  CALL  "SHDMOH" 

Data-Length  »  17 
Mane-String  -  Table  Mane 
Processing-Code  -  Blank 
On  CALL  “SMDSAP" 

Entire  Header 


Mo  Authorization 

34001 

Entire 

Header 

Illegal 

Message  Type 

34002 

Entire 

Header 

Inval id 

Destination 

34003 

Entire 

Header 

E-103 
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